minotor 1.0.6 → 2.0.0

package/dist/gtfs/stops.d.ts

@@ -1,20 +1,34 @@
-import { Latitude, Longitude, Platform, StopId, StopsMap } from '../stops/stops.js';
+import { Latitude, Longitude, Platform, SourceStopId, Stop, StopId, StopsMap } from '../stops/stops.js';
 import { Maybe } from './utils.js';
-export type StopIds = Set<StopId>;
 export type GtfsLocationType = 0 | 1 | 2 | 3 | 4;
 export type StopEntry = {
-    stop_id: StopId;
+    stop_id: SourceStopId;
     stop_name: string;
     stop_lat?: Latitude;
     stop_lon?: Longitude;
     location_type?: GtfsLocationType;
-    parent_station?: StopId;
+    parent_station?: SourceStopId;
     platform_code?: Platform;
 };
+type ParsedStop = Stop & {
+    parentSourceId?: SourceStopId;
+};
+export type ParsedStopsMap = Map<SourceStopId, ParsedStop>;
 /**
  * Parses the stops.txt file from a GTFS feed.
  *
  * @param stopsStream The readable stream containing the stops data.
  * @return A mapping of stop IDs to corresponding stop details.
  */
-export declare const parseStops: (stopsStream: NodeJS.ReadableStream, platformParser?: (stopEntry: StopEntry) => Maybe<Platform>, validStops?: StopIds) => Promise<StopsMap>;
+export declare const parseStops: (stopsStream: NodeJS.ReadableStream, platformParser?: (stopEntry: StopEntry) => Maybe<Platform>) => Promise<ParsedStopsMap>;
+/**
+ * Builds the final stop map indexed by internal IDs.
+ * Excludes all stops that do not have at least one valid stopId
+ * as a child, a parent, or being valid itself.
+ *
+ * @param parsedStops - The map of parsed stops.
+ * @param validStops - A set of valid stop IDs.
+ * @returns A map of stops indexed by internal IDs.
+ */
+export declare const indexStops: (parsedStops: ParsedStopsMap, validStops?: Set<StopId>) => StopsMap;
+export {};

package/dist/gtfs/transfers.d.ts

@@ -1,11 +1,12 @@
-import { StopId } from '../stops/stops.js';
+import { SourceStopId, StopId } from '../stops/stops.js';
 import { ServiceRouteId, Transfer } from '../timetable/timetable.js';
+import { ParsedStopsMap } from './stops.js';
 import { TripId } from './trips.js';
 export type GtfsTransferType = 0 | 1 | 2 | 3 | 4 | 5;
 export type TransfersMap = Map<StopId, Transfer[]>;
 export type TransferEntry = {
-    from_stop_id?: StopId;
-    to_stop_id?: StopId;
+    from_stop_id?: SourceStopId;
+    to_stop_id?: SourceStopId;
     from_trip_id?: TripId;
     to_trip_id?: TripId;
     from_route_id?: ServiceRouteId;
@@ -19,4 +20,4 @@ export type TransferEntry = {
  * @param stopsStream The readable stream containing the stops data.
  * @return A mapping of stop IDs to corresponding stop details.
  */
-export declare const parseTransfers: (transfersStream: NodeJS.ReadableStream) => Promise<TransfersMap>;
+export declare const parseTransfers: (transfersStream: NodeJS.ReadableStream, stopsMap: ParsedStopsMap) => Promise<TransfersMap>;

package/dist/gtfs/trips.d.ts

@@ -1,6 +1,7 @@
+import { StopId } from '../stops/stops.js';
 import { RoutesAdjacency, ServiceRouteId, ServiceRoutesMap, StopsAdjacency } from '../timetable/timetable.js';
 import { ServiceIds } from './services.js';
-import { StopIds } from './stops.js';
+import { ParsedStopsMap } from './stops.js';
 import { TransfersMap } from './transfers.js';
 export type TripId = string;
 export type TripIdsMap = Map<TripId, ServiceRouteId>;
@@ -14,13 +15,14 @@ export type GtfsPickupDropOffType = '' | 0 | 1 | 2 | 3;
  * @returns A mapping of trip IDs to corresponding route IDs.
  */
 export declare const parseTrips: (tripsStream: NodeJS.ReadableStream, serviceIds: ServiceIds, routeIds: ServiceRoutesMap) => Promise<TripIdsMap>;
-export declare const buildStopsAdjacencyStructure: (validStops: StopIds, routes: RoutesAdjacency, transfersMap: TransfersMap) => StopsAdjacency;
+export declare const buildStopsAdjacencyStructure: (validStops: Set<StopId>, routes: RoutesAdjacency, transfersMap: TransfersMap) => StopsAdjacency;
 /**
  * Parses the stop_times.txt data from a GTFS feed.
  *
  * @param stopTimesStream The readable stream containing the stop times data.
+ * @param stopsMap A map of parsed stops from the GTFS feed.
  * @param validTripIds A map of valid trip IDs to corresponding route IDs.
- * @param validStopIds A map of valid stop IDs.
- * @returns A mapping of route IDs to route details. The routes return corresponds to the set of trips from GTFS that share the same stop list.
+ * @param validStopIds A set of valid stop IDs.
+ * @returns A mapping of route IDs to route details. The routes returned correspond to the set of trips from GTFS that share the same stop list.
  */
-export declare const parseStopTimes: (stopTimesStream: NodeJS.ReadableStream, validTripIds: TripIdsMap, validStopIds: StopIds) => Promise<RoutesAdjacency>;
+export declare const parseStopTimes: (stopTimesStream: NodeJS.ReadableStream, stopsMap: ParsedStopsMap, validTripIds: TripIdsMap, validStopIds: Set<StopId>) => Promise<RoutesAdjacency>;

package/dist/gtfs/utils.d.ts

@@ -1,17 +1,16 @@
 import { Parser } from 'csv-parse';
 export type Maybe<T> = T | undefined;
 /**
- * Generates a simple hash from a string.
+ * Generates a simple hash from an array of numeric IDs.
  *
- * This function computes a hash for a given string by iterating over each
- * character and applying bitwise operations to accumulate a hash value.
- * The final hash is then converted to a base-36 string and padded to
- * ensure a minimum length of 6 characters.
+ * This function computes a hash for a given array of numbers by iterating over each
+ * ID and applying bitwise operations to accumulate a hash value.
+ * The final hash is then converted to a base-36 string.
  *
- * @param str - The input string to hash.
- * @returns A hashed string representation of the input.
+ * @param ids - The array of numeric IDs to hash.
+ * @returns A hashed string representation of the input array.
  */
-export declare const hash: (str: string) => string;
+export declare const hashIds: (ids: number[]) => string;
 /**
  * Parses a CSV stream with a sensible configuration for GTFS feeds.
  *