corequery-gtfs 0.1.0 → 0.1.2

package/dist/parser/schedule/gtfs-transfer-connector.js

@@ -0,0 +1,168 @@
+import { GtfsScheduledTrip } from "../../data/gtfs-scheduled-trip.js";
+const TRANSFER_TYPE_IN_SEAT_TRANSFER = 4;
+export class GtfsTransferConnector {
+    _onError;
+    constructor(_onError) {
+        this._onError = _onError;
+    }
+    connect(trips, transfers) {
+        const tripMap = new Map(trips.map((trip) => [trip.gtfsTripId, trip]));
+        for (const transfer of transfers) {
+            const fromTrip = tripMap.get(transfer.from_trip_id);
+            const toTrip = tripMap.get(transfer.to_trip_id);
+            // TrainQuery only cares about "in-seat" transfers, because we're only
+            // parsing these transfers to form trips into multiple "legs" of a
+            // service, a.k.a. what I used to call continuations.
+            //
+            // We should ignore them, but it's not really an error. I'm just reporting
+            // them because right now PTV only publishes in-seat transfers, and I'm
+            // curious to see if that changes one day (e.g. with V/Line's guaranteed
+            // coach connections, or coupling of trains at Ballarat).
+            if (transfer.transfer_type !== TRANSFER_TYPE_IN_SEAT_TRANSFER) {
+                this._onError(new TransferIsNotInSeatTransferError(transfer));
+                continue;
+            }
+            if (fromTrip == null) {
+                const Err = TransferReferencesNonExistentTrip;
+                this._onError(new Err(transfer, "from_trip_id"));
+                continue;
+            }
+            if (toTrip == null) {
+                const Err = TransferReferencesNonExistentTrip;
+                this._onError(new Err(transfer, "to_trip_id"));
+                continue;
+            }
+            if (transfer.from_stop_id !== transfer.to_stop_id) {
+                this._onError(new TransferIsNotSameStopAndPositionError(transfer));
+                continue;
+            }
+            // As alluded to above, I suspect one day V/Line might make things
+            // difficult if they start (accurately, to be fair) considering their
+            // Maryborough shuttles as "in-seat" transfers because the trains couple
+            // at Ballarat. No idea how we'd even want to _display_ those, let alone
+            // model it!
+            if (fromTrip.termination.gtfsIdMetadata.id !== transfer.from_stop_id) {
+                this._onError(new TransferIsNotFromTerminusError(transfer, fromTrip));
+                continue;
+            }
+            if (toTrip.origination.gtfsIdMetadata.id !== transfer.to_stop_id) {
+                this._onError(new TransferIsNotToOriginError(transfer, toTrip));
+                continue;
+            }
+            if (fromTrip.nextTrip != null) {
+                const Err = TransferReferencesTripAlreadyConnectedError;
+                this._onError(new Err(transfer, fromTrip));
+                continue;
+            }
+            if (toTrip.previousTrip != null) {
+                const Err = TransferReferencesTripAlreadyConnectedError;
+                this._onError(new Err(transfer, toTrip));
+                continue;
+            }
+            // TODO: I'm gonna let this one slide, so long as we remember to:
+            // - When filtering out arrivals for trips which ultimately continue, make
+            //   sure to check the next trip runs on that service day. ✅
+            // - When building the services for corequery (either through the
+            //   departures algorithm, or lookup by ID), only add the extra leg if the
+            //   next trip runs on that service day.
+            if (fromTrip.calendar.gtfsCalendarId !== toTrip.calendar.gtfsCalendarId) {
+                this._onError(new TransferCrossesCalendarsError(transfer));
+            }
+            // I'm assuming transfers would only be made by trips running on the same
+            // service day, not just "the next instance of this trip". If it were the
+            // latter you could have a trip terminating at 24:30 connecting to a trip
+            // originating at 00:32.
+            //
+            // (If that WERE to happen, it might be acceptable to just not connect
+            // them (as we're doing now) as it'd surely only be a couple weird
+            // overnight trips. Otherwise, would it be practical to shift the next
+            // trip into the same service day retroactively by rewriting its departure
+            // and arrival times and shifting its calendar by one day? Or would it be
+            // less destructive to have some transfer metadata to say the next trip is
+            // +1 day from this one.)
+            const fromArrivalTime = fromTrip.termination.arrivalTime;
+            const toDepartureTime = toTrip.origination.departureTime;
+            if (fromArrivalTime.isAfter(toDepartureTime)) {
+                this._onError(new TransferRequiresTimeTravelError(transfer));
+                continue;
+            }
+            const [newFrom, newTo] = GtfsScheduledTrip.connectAsTransfer(fromTrip, toTrip);
+            tripMap.set(fromTrip.gtfsTripId, newFrom);
+            tripMap.set(toTrip.gtfsTripId, newTo);
+        }
+        return Array.from(tripMap.values());
+    }
+}
+export class TransferReferencesNonExistentTrip extends Error {
+    transfer;
+    field;
+    type = "transfer-references-non-existent-trip";
+    constructor(transfer, field) {
+        super();
+        this.transfer = transfer;
+        this.field = field;
+    }
+}
+export class TransferIsNotFromTerminusError extends Error {
+    transfer;
+    fromTrip;
+    type = "transfer-is-not-from-terminus";
+    constructor(transfer, fromTrip) {
+        super();
+        this.transfer = transfer;
+        this.fromTrip = fromTrip;
+    }
+}
+export class TransferIsNotToOriginError extends Error {
+    transfer;
+    toTrip;
+    type = "transfer-is-not-to-origin";
+    constructor(transfer, toTrip) {
+        super();
+        this.transfer = transfer;
+        this.toTrip = toTrip;
+    }
+}
+export class TransferReferencesTripAlreadyConnectedError extends Error {
+    transfer;
+    tripWithExistingConnection;
+    type = "transfer-references-trip-already-connected";
+    constructor(transfer, tripWithExistingConnection) {
+        super();
+        this.transfer = transfer;
+        this.tripWithExistingConnection = tripWithExistingConnection;
+    }
+}
+export class TransferIsNotInSeatTransferError extends Error {
+    transfer;
+    type = "transfer-is-not-in-seat-transfer";
+    constructor(transfer) {
+        super();
+        this.transfer = transfer;
+    }
+}
+export class TransferIsNotSameStopAndPositionError extends Error {
+    transfer;
+    type = "transfer-is-not-same-stop-and-position";
+    constructor(transfer) {
+        super();
+        this.transfer = transfer;
+    }
+}
+export class TransferCrossesCalendarsError extends Error {
+    transfer;
+    type = "transfer-crosses-calendars";
+    constructor(transfer) {
+        super();
+        this.transfer = transfer;
+    }
+}
+export class TransferRequiresTimeTravelError extends Error {
+    transfer;
+    type = "transfer-requires-time-travel";
+    constructor(transfer) {
+        super();
+        this.transfer = transfer;
+    }
+}
+//# sourceMappingURL=gtfs-transfer-connector.js.map

package/dist/parser/schedule/gtfs-transfer-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtfs-transfer-connector.js","sourceRoot":"","sources":["../../../src/parser/schedule/gtfs-transfer-connector.ts"],"names":[],"mappings":"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"}

package/dist/parser/schedule/gtfs-trip-parser.d.ts

@@ -0,0 +1,45 @@
+import type { LineGtfsIdMapping } from "../../data/ids/line-gtfs-id-mapping.js";
+import type { StopGtfsIdMapping } from "../../data/ids/stop-gtfs-id-mapping.js";
+import type { StopTimesCsv, StopTimesCsvRow, TransfersCsv, TripsCsv, TripsCsvRow } from "../../data/raw/schedule-csvs.js";
+import type { GtfsCalendar } from "../../data/gtfs-calendar.js";
+import { GtfsScheduledTrip } from "../../data/gtfs-scheduled-trip.js";
+import { type GtfsStopTimeNormalisationError } from "./gtfs-stop-time-normaliser.js";
+import { type GtfsRouteMatchingError } from "./gtfs-route-matcher.js";
+import { type GtfsTransferConnectionError } from "./gtfs-transfer-connector.js";
+import type { LineRoutesMapping } from "../../data/route/line-routes-mapping.js";
+import type { BonusLinesMapping } from "../../data/route/bonus-lines-mapping.js";
+export declare class GtfsTripParser {
+    private readonly _lineRoutesMapping;
+    private readonly _bonusLinesMapping;
+    private readonly _onError;
+    private readonly _stopTimeNormaliser;
+    private readonly _primaryRouteMatcher;
+    private readonly _bonusRouteMatcher;
+    private readonly _transferConnector;
+    constructor(_lineRoutesMapping: LineRoutesMapping, _bonusLinesMapping: BonusLinesMapping, _onError: (error: GtfsTripParsingError) => void);
+    parse(trips: TripsCsv, stopTimes: StopTimesCsv, transfers: TransfersCsv, calendars: readonly GtfsCalendar[], lineGtfsIdMapping: LineGtfsIdMapping, stopGtfsIdMapping: StopGtfsIdMapping): readonly GtfsScheduledTrip[];
+    private _organiseStopTimesIntoTrips;
+    private _applyBonusLines;
+    private _buildCalendarMap;
+}
+export type GtfsTripParsingError = StopTimeReferencesNonExistentTripError | DuplicateTripIdError | TripReferencesNonExistentCalendarError | TripReferencesUnmappedRouteIdError | GtfsStopTimeNormalisationError | GtfsRouteMatchingError | GtfsTransferConnectionError;
+export declare class StopTimeReferencesNonExistentTripError extends Error {
+    readonly stopTime: StopTimesCsvRow;
+    readonly type = "stop-time-references-non-existent-trip";
+    constructor(stopTime: StopTimesCsvRow);
+}
+export declare class DuplicateTripIdError extends Error {
+    readonly subsequentRowWithDuplicateId: TripsCsvRow;
+    readonly type = "duplicate-trip-id";
+    constructor(subsequentRowWithDuplicateId: TripsCsvRow);
+}
+export declare class TripReferencesNonExistentCalendarError extends Error {
+    readonly trip: TripsCsvRow;
+    readonly type = "trip-references-non-existent-calendar";
+    constructor(trip: TripsCsvRow);
+}
+export declare class TripReferencesUnmappedRouteIdError extends Error {
+    readonly trip: TripsCsvRow;
+    readonly type = "trip-references-unmapped-route-id";
+    constructor(trip: TripsCsvRow);
+}

package/dist/parser/schedule/gtfs-trip-parser.js

@@ -0,0 +1,169 @@
+import { GtfsScheduledTrip } from "../../data/gtfs-scheduled-trip.js";
+import { GtfsStopTimeNormaliser, } from "./gtfs-stop-time-normaliser.js";
+import { GtfsRouteMatcher, } from "./gtfs-route-matcher.js";
+import { GtfsTransferConnector, } from "./gtfs-transfer-connector.js";
+export class GtfsTripParser {
+    _lineRoutesMapping;
+    _bonusLinesMapping;
+    _onError;
+    _stopTimeNormaliser;
+    _primaryRouteMatcher;
+    _bonusRouteMatcher;
+    _transferConnector;
+    constructor(
+    // Unlike csvs, lineGtfsIdMapping, and stopGtfsIdMapping, these are not
+    // subfeed-dependent, so I'm opting to make them constructor args.
+    _lineRoutesMapping, _bonusLinesMapping, _onError) {
+        this._lineRoutesMapping = _lineRoutesMapping;
+        this._bonusLinesMapping = _bonusLinesMapping;
+        this._onError = _onError;
+        this._stopTimeNormaliser = new GtfsStopTimeNormaliser(this._onError);
+        this._primaryRouteMatcher = new GtfsRouteMatcher(this._onError);
+        this._transferConnector = new GtfsTransferConnector(this._onError);
+        // We don't care if a bonus route doesn't match. Most of the time, it won't!
+        this._bonusRouteMatcher = new GtfsRouteMatcher(() => { });
+    }
+    parse(trips, stopTimes, transfers, calendars, lineGtfsIdMapping, stopGtfsIdMapping) {
+        const calendarMap = this._buildCalendarMap(calendars);
+        const rowsByTrip = this._organiseStopTimesIntoTrips(trips, stopTimes);
+        const unconnectedTrips = [];
+        for (const { trip, stopTimes } of rowsByTrip) {
+            const calendar = calendarMap.get(trip.service_id);
+            if (calendar == null) {
+                this._onError(new TripReferencesNonExistentCalendarError(trip));
+                continue;
+            }
+            const lineIdMatch = lineGtfsIdMapping.tryResolve(trip.route_id);
+            if (lineIdMatch == null) {
+                this._onError(new TripReferencesUnmappedRouteIdError(trip));
+                continue;
+            }
+            if (lineIdMatch.type === "replacement-bus")
+                continue;
+            const normalizedStopTimes = this._stopTimeNormaliser.normalise(stopTimes);
+            // Stop time normaliser reports its own errors.
+            if (normalizedStopTimes == null)
+                continue;
+            const routesForLine = this._lineRoutesMapping.forLine(lineIdMatch.lineId);
+            const routeMatchResult = this._primaryRouteMatcher.match(normalizedStopTimes, routesForLine, stopGtfsIdMapping);
+            // Route matcher reports its own errors.
+            if (routeMatchResult == null)
+                continue;
+            const { lineIds, serviceTags } = this._applyBonusLines(lineIdMatch.lineId, routeMatchResult.serviceTags, normalizedStopTimes, stopGtfsIdMapping);
+            unconnectedTrips.push(new GtfsScheduledTrip({
+                gtfsTripId: trip.trip_id,
+                gtfsRouteId: trip.route_id,
+                calendar,
+                movements: routeMatchResult.movements,
+                lineIds,
+                color: routeMatchResult.color,
+                serviceTags,
+                previousTrip: null,
+                nextTrip: null,
+            }));
+        }
+        return this._transferConnector.connect(unconnectedTrips, transfers);
+    }
+    _organiseStopTimesIntoTrips(trips, stopTimes) {
+        const result = new Map();
+        // Step 1: Build a map from everything in trips.txt.
+        for (const trip of trips) {
+            if (result.has(trip.trip_id)) {
+                // We only keep the first trip we see for a given trip_id, I guess.
+                this._onError(new DuplicateTripIdError(trip));
+                continue;
+            }
+            result.set(trip.trip_id, { trip, stopTimes: [] });
+        }
+        // Step 2: Iterate through stop_times.txt and add each row to the
+        // appropriate trip.
+        for (const stopTime of stopTimes) {
+            const trip = result.get(stopTime.trip_id);
+            if (trip == null) {
+                // It's likely if something's missing from trips.txt that multiple
+                // stop_times.txt rows will reference it. However, I consider it out of
+                // scope for the parser to group those errors. Something which listens
+                // for the errors (i.e. to build some report) is responsible for that.
+                this._onError(new StopTimeReferencesNonExistentTripError(stopTime));
+                continue;
+            }
+            trip.stopTimes.push(stopTime);
+        }
+        // Step 3: Convert to an array. Do NOT sort by stop_sequence, as the stop
+        // time normaliser is interested in the original order of the rows in
+        // stop_times.txt for some special case handling (i.e. PTV has published
+        // invalid data, but we can still interpret it).
+        return Array.from(result.values()).map((group) => ({
+            ...group,
+            stopTimes: group.stopTimes,
+        }));
+    }
+    _applyBonusLines(mainRouteLineId, mainRouteServiceTags, normalizedStopTimes, stopGtfsIdMapping) {
+        const bonusLines = this._bonusLinesMapping.forLine(mainRouteLineId);
+        if (bonusLines == null) {
+            return { lineIds: [mainRouteLineId], serviceTags: mainRouteServiceTags };
+        }
+        // Go through all bonus lines, and collect the line IDs and service tags
+        // for any routes that match.
+        const lineIds = new Set();
+        const serviceTags = new Set();
+        for (const bonusLine of bonusLines.lines) {
+            const matchResult = this._bonusRouteMatcher.match(normalizedStopTimes, this._lineRoutesMapping.forLine(bonusLine), stopGtfsIdMapping);
+            if (matchResult != null) {
+                lineIds.add(bonusLine);
+                for (const serviceTag of matchResult.serviceTags) {
+                    serviceTags.add(serviceTag);
+                }
+            }
+        }
+        // If in "replace" mode, we throw away the main route's line ID and tags if
+        // anything else matches. Otherwise they're added on.
+        const shouldReplace = lineIds.size > 0 && bonusLines.mode === "replace";
+        if (!shouldReplace) {
+            lineIds.add(mainRouteLineId);
+            for (const serviceTag of mainRouteServiceTags) {
+                serviceTags.add(serviceTag);
+            }
+        }
+        return {
+            lineIds: Array.from(lineIds),
+            serviceTags: Array.from(serviceTags),
+        };
+    }
+    _buildCalendarMap(calendars) {
+        return new Map(calendars.map((c) => [c.gtfsCalendarId, c]));
+    }
+}
+export class StopTimeReferencesNonExistentTripError extends Error {
+    stopTime;
+    type = "stop-time-references-non-existent-trip";
+    constructor(stopTime) {
+        super();
+        this.stopTime = stopTime;
+    }
+}
+export class DuplicateTripIdError extends Error {
+    subsequentRowWithDuplicateId;
+    type = "duplicate-trip-id";
+    constructor(subsequentRowWithDuplicateId) {
+        super();
+        this.subsequentRowWithDuplicateId = subsequentRowWithDuplicateId;
+    }
+}
+export class TripReferencesNonExistentCalendarError extends Error {
+    trip;
+    type = "trip-references-non-existent-calendar";
+    constructor(trip) {
+        super();
+        this.trip = trip;
+    }
+}
+export class TripReferencesUnmappedRouteIdError extends Error {
+    trip;
+    type = "trip-references-unmapped-route-id";
+    constructor(trip) {
+        super();
+        this.trip = trip;
+    }
+}
+//# sourceMappingURL=gtfs-trip-parser.js.map

package/dist/parser/schedule/gtfs-trip-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtfs-trip-parser.js","sourceRoot":"","sources":["../../../src/parser/schedule/gtfs-trip-parser.ts"],"names":[],"mappings":"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"}

package/dist/parser/schedule/index.d.ts

@@ -0,0 +1,6 @@
+export type { GtfsCalendarParsingError, DuplicateCalendarIdError, UnexpectedCalendarDateExceptionTypeError, InvalidCalendarDateRangeError, MultipleExceptionsForSameDateError, } from "./gtfs-calendar-parser.js";
+export type { GtfsRouteMatchingError, NoMatchingRouteError, StopTimeReferencesUnmappedStopIdError, UnexpectedPickupTypeError, UnexpectedDropOffTypeError, } from "./gtfs-route-matcher.js";
+export type { GtfsScheduleParsingError } from "./gtfs-schedule-parser.js";
+export type { GtfsStopTimeNormalisationError, InvalidStopSequenceError, MultipleStopSequencesError, } from "./gtfs-stop-time-normaliser.js";
+export type { GtfsTransferConnectionError, TransferReferencesNonExistentTrip, TransferIsNotFromTerminusError, TransferIsNotToOriginError, TransferReferencesTripAlreadyConnectedError, TransferIsNotInSeatTransferError, TransferIsNotSameStopAndPositionError, TransferCrossesCalendarsError, TransferRequiresTimeTravelError, } from "./gtfs-transfer-connector.js";
+export type { GtfsTripParsingError, StopTimeReferencesNonExistentTripError, DuplicateTripIdError, TripReferencesNonExistentCalendarError, TripReferencesUnmappedRouteIdError, } from "./gtfs-trip-parser.js";

package/dist/parser/schedule/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/parser/schedule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/schedule/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "corequery-gtfs",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "files": [
     "dist"
   ],
-  "exports": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
+  "exports": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json",
     "test": "vitest --run",