corequery-gtfs 0.1.0 → 0.1.2

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

@@ -0,0 +1,113 @@
+import { GtfsCalendar } from "../../data/gtfs-calendar.js";
+import { PlainDateRange } from "../../data/plain-date-range.js";
+const CALENDAR_DATE_EXCEPTION_TYPE_ADDED = 1;
+const CALENDAR_DATE_EXCEPTION_TYPE_REMOVED = 2;
+export class GtfsCalendarParser {
+    _onError;
+    constructor(_onError) {
+        this._onError = _onError;
+    }
+    parse(calendarCsv, calendarDatesCsv) {
+        const calendarData = new Map();
+        const calendarsToIgnore = new Set();
+        // Step 1: Process rows in calendar.txt.
+        for (const row of calendarCsv) {
+            if (calendarData.has(row.service_id)) {
+                // We only keep the calendar we see for a given service_id, I guess.
+                this._onError(new DuplicateCalendarIdError(row));
+                continue;
+            }
+            if (Temporal.PlainDate.compare(row.start_date, row.end_date) > 0) {
+                this._onError(new InvalidCalendarDateRangeError(row));
+                calendarsToIgnore.add(row.service_id);
+                continue;
+            }
+            calendarData.set(row.service_id, {
+                id: row.service_id,
+                baseRow: row,
+                addedDates: [],
+                removedDates: [],
+            });
+        }
+        // Step 2: Process rows in calendar_dates.txt, modifying or adding new
+        // calendars as necessary.
+        for (const row of calendarDatesCsv) {
+            // If something goes wrong parsing the row in calendar.txt, don't act as
+            // though no row was present. Ignore calendar_dates.txt rows for it too.
+            if (calendarsToIgnore.has(row.service_id))
+                continue;
+            const calendar = calendarData.get(row.service_id) ?? {
+                id: row.service_id,
+                baseRow: null,
+                addedDates: [],
+                removedDates: [],
+            };
+            if (calendar.addedDates.includes(row.date) ||
+                calendar.removedDates.includes(row.date)) {
+                // Report this weirdness, but keep going. My GtfsCalendar implementation
+                // will ultimately give added dates priority.
+                this._onError(new MultipleExceptionsForSameDateError(row));
+            }
+            if (row.exception_type === CALENDAR_DATE_EXCEPTION_TYPE_ADDED) {
+                calendar.addedDates.push(row.date);
+            }
+            else if (row.exception_type === CALENDAR_DATE_EXCEPTION_TYPE_REMOVED) {
+                calendar.removedDates.push(row.date);
+            }
+            else {
+                this._onError(new UnexpectedCalendarDateExceptionTypeError(row));
+                continue;
+            }
+            calendarData.set(row.service_id, calendar);
+        }
+        // Step 3: Convert to GtfsCalendar instances.
+        return Array.from(calendarData.values()).map((data) => {
+            const baseRow = data.baseRow ?? {
+                service_id: data.id,
+                monday: false,
+                tuesday: false,
+                wednesday: false,
+                thursday: false,
+                friday: false,
+                saturday: false,
+                sunday: false,
+                start_date: null,
+                end_date: null,
+            };
+            return new GtfsCalendar(data.id, baseRow.monday, baseRow.tuesday, baseRow.wednesday, baseRow.thursday, baseRow.friday, baseRow.saturday, baseRow.sunday, new PlainDateRange(baseRow.start_date, baseRow.end_date), data.addedDates, data.removedDates);
+        });
+    }
+}
+export class DuplicateCalendarIdError extends Error {
+    subsequentRowWithDuplicateId;
+    type = "duplicate-calendar";
+    constructor(subsequentRowWithDuplicateId) {
+        super();
+        this.subsequentRowWithDuplicateId = subsequentRowWithDuplicateId;
+    }
+}
+export class InvalidCalendarDateRangeError extends Error {
+    row;
+    type = "invalid-calendar-date-range";
+    constructor(row) {
+        super();
+        this.row = row;
+    }
+}
+export class UnexpectedCalendarDateExceptionTypeError extends Error {
+    row;
+    type = "unexpected-calendar-date-exception-type";
+    constructor(row) {
+        super();
+        this.row = row;
+    }
+}
+export class MultipleExceptionsForSameDateError extends Error {
+    subsequentRowForSameDate;
+    type = "multiple-exceptions-for-same-date";
+    constructor(subsequentRowForSameDate) {
+        super();
+        this.subsequentRowForSameDate = subsequentRowForSameDate;
+    }
+}
+//# sourceMappingURL=gtfs-calendar-parser.js.map

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

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

package/dist/parser/schedule/gtfs-route-matcher.d.ts

@@ -0,0 +1,48 @@
+import type { Color } from "../../corequery-types.js";
+import type { StopTimesCsv, StopTimesCsvRow } from "../../data/raw/schedule-csvs.js";
+import type { StopGtfsIdMapping } from "../../data/ids/stop-gtfs-id-mapping.js";
+import type { Route } from "../../data/route/route.js";
+import { type GtfsScheduledTripMovement } from "../../data/gtfs-scheduled-trip-movements.js";
+export type MatchedRoute = {
+    movements: readonly GtfsScheduledTripMovement[];
+    color: Color | null;
+    serviceTags: readonly number[];
+};
+export declare class GtfsRouteMatcher {
+    private readonly _onError;
+    constructor(_onError: (error: GtfsRouteMatchingError) => void);
+    match(stopTimes: StopTimesCsv, routesForLine: readonly Route[], stopGtfsIdMapping: StopGtfsIdMapping): MatchedRoute | null;
+    private _matchToRoute;
+    private _addPassingMovementsFromRoute;
+    /**
+     * Take the rows from stop_times.txt and form a
+     * GtfsScheduledTripServicingMovement for each. Note that passing movements
+     * are not added at this stage. They're sprinkled in later once we've matched
+     * the trip to a route.
+     */
+    private _convertToServicingMovements;
+    private _doesPickUp;
+    private _doesDropOff;
+}
+export type GtfsRouteMatchingError = NoMatchingRouteError | StopTimeReferencesUnmappedStopIdError | UnexpectedPickupTypeError | UnexpectedDropOffTypeError;
+export declare class NoMatchingRouteError extends Error {
+    readonly stopTimes: StopTimesCsv;
+    readonly resolvedStopIds: readonly number[];
+    readonly type = "no-matching-route";
+    constructor(stopTimes: StopTimesCsv, resolvedStopIds: readonly number[]);
+}
+export declare class StopTimeReferencesUnmappedStopIdError extends Error {
+    readonly stopTime: StopTimesCsvRow;
+    readonly type = "stop-time-references-unmapped-stop-id";
+    constructor(stopTime: StopTimesCsvRow);
+}
+export declare class UnexpectedPickupTypeError extends Error {
+    readonly stopTime: StopTimesCsvRow;
+    readonly type = "unexpected-pickup-type";
+    constructor(stopTime: StopTimesCsvRow);
+}
+export declare class UnexpectedDropOffTypeError extends Error {
+    readonly stopTime: StopTimesCsvRow;
+    readonly type = "unexpected-drop-off-type";
+    constructor(stopTime: StopTimesCsvRow);
+}

package/dist/parser/schedule/gtfs-route-matcher.js

@@ -0,0 +1,199 @@
+import { GtfsScheduledTripOriginatingMovement, GtfsScheduledTripPassingMovement, GtfsScheduledTripRegularMovement, GtfsScheduledTripTerminatingMovement, } from "../../data/gtfs-scheduled-trip-movements.js";
+import { itsOk } from "@dan-schel/js-utils";
+const STOP_TIME_PICKUP_TYPE_REGULAR = 0;
+const STOP_TIME_PICKUP_TYPE_NO_PICKUP = 1;
+const STOP_TIME_DROP_OFF_TYPE_REGULAR = 0;
+const STOP_TIME_DROP_OFF_TYPE_NO_DROP_OFF = 1;
+export class GtfsRouteMatcher {
+    _onError;
+    constructor(_onError) {
+        this._onError = _onError;
+    }
+    match(stopTimes, routesForLine, stopGtfsIdMapping) {
+        const servicingMovements = this._convertToServicingMovements(stopTimes, stopGtfsIdMapping);
+        if (servicingMovements == null)
+            return null;
+        const match = this._matchToRoute(servicingMovements, routesForLine);
+        if (match == null) {
+            const stopIds = servicingMovements.map((movement) => movement.stopId);
+            this._onError(new NoMatchingRouteError(stopTimes, stopIds));
+            return null;
+        }
+        return match;
+    }
+    _matchToRoute(servicingMovements, routesForLine) {
+        // Step 1: Find the shortest route for this line which contains all the
+        // stops where the trip services as a subsequence.
+        const shortestMatch = routesForLine
+            .filter((r) => r.matchesStoppingOrder(servicingMovements.map((m) => m.stopId)))
+            .reduce((prev, me) => (prev == null || me.isShorterThan(prev) ? me : prev), null);
+        if (shortestMatch == null)
+            return null;
+        const { color, serviceTags } = shortestMatch;
+        // Step 2: Since stop_times.txt in GTFS only lists the stops the service
+        // actually serves (i.e. it doesn't have the express stops), use the matched
+        // route as a guide for which stops the service skipped, and add those into
+        // the list as passing movements.
+        const movements = this._addPassingMovementsFromRoute(servicingMovements, shortestMatch);
+        return { movements, color, serviceTags };
+    }
+    _addPassingMovementsFromRoute(servicingMovements, matchingRoute) {
+        const result = [];
+        let nextServicingMovementIndex = 0;
+        // Broadly: Iterate through the route's stops, and step through the trip
+        // movements simultaneously when they match. Add all route stops between
+        // first and last trip movements as servicing movements where found or
+        // passing movements otherwise.
+        for (const routeStop of matchingRoute.stops) {
+            const nextServicingMovement = servicingMovements[nextServicingMovementIndex];
+            // If there's no next servicing movement, then the index must be off the
+            // end of the array, so we're done (the service has terminated).
+            if (nextServicingMovement == null)
+                break;
+            if (routeStop.stopId === nextServicingMovement.stopId) {
+                // When the next movement from the trip matches the one in the route
+                // we're up to, add the servicing movement.
+                result.push(nextServicingMovement);
+                nextServicingMovementIndex++;
+            }
+            else if (nextServicingMovementIndex > 0 &&
+                !routeStop.collapseInStoppingPatterns) {
+                // Otherwise the stop from the route is an `type: "passing"` movement.
+                // `nextServicingMovementIndex > 0` stops us adding passing movements
+                // from the route before the service originates.
+                //
+                // For now, I'm skipping adding `collapseInStoppingPatterns` stops as
+                // passing movements. This flag means we don't want this stop to show up
+                // in stopping patterns normally, unless it's servicing (e.g. East
+                // Pakenham on the Gippsland line is one of these). I'm assuming there's
+                // nothing downstream that'll need to consider these collapsed stops.
+                //
+                // (If I need to reconsider this decision for some reason, maybe instead
+                // of adding those stops back in to this array with some sort of flag, I
+                // could consider adding the matched route itself as metadata to the
+                // trip? Probably having the index of the route stop in this array will
+                // be useful to reconcile the two.)
+                result.push(new GtfsScheduledTripPassingMovement({
+                    stopId: routeStop.stopId,
+                }));
+            }
+        }
+        return result;
+    }
+    /**
+     * Take the rows from stop_times.txt and form a
+     * GtfsScheduledTripServicingMovement for each. Note that passing movements
+     * are not added at this stage. They're sprinkled in later once we've matched
+     * the trip to a route.
+     */
+    _convertToServicingMovements(stopTimes, stopGtfsIdMapping) {
+        const result = [];
+        for (let i = 0; i < stopTimes.length; i++) {
+            const stopTime = itsOk(stopTimes[i]);
+            const gtfsIdMetadata = stopGtfsIdMapping.tryResolve(stopTime.stop_id);
+            if (gtfsIdMetadata == null) {
+                this._onError(new StopTimeReferencesUnmappedStopIdError(stopTime));
+                return null;
+            }
+            const positionId = gtfsIdMetadata.type === "platform" ? gtfsIdMetadata.positionId : null;
+            const picksUp = this._doesPickUp(stopTime);
+            const dropsOff = this._doesDropOff(stopTime);
+            if (i === 0) {
+                result.push(new GtfsScheduledTripOriginatingMovement({
+                    stopId: gtfsIdMetadata.stopId,
+                    positionId,
+                    departureTime: stopTime.departure_time,
+                    gtfsIdMetadata,
+                    gtfsStopSequence: stopTime.stop_sequence,
+                }));
+            }
+            else if (i === stopTimes.length - 1) {
+                result.push(new GtfsScheduledTripTerminatingMovement({
+                    stopId: gtfsIdMetadata.stopId,
+                    positionId,
+                    arrivalTime: stopTime.arrival_time,
+                    gtfsIdMetadata,
+                    gtfsStopSequence: stopTime.stop_sequence,
+                }));
+            }
+            else {
+                result.push(new GtfsScheduledTripRegularMovement({
+                    stopId: gtfsIdMetadata.stopId,
+                    positionId,
+                    arrivalTime: stopTime.arrival_time,
+                    departureTime: stopTime.departure_time,
+                    picksUp,
+                    dropsOff,
+                    gtfsIdMetadata,
+                    gtfsStopSequence: stopTime.stop_sequence,
+                }));
+            }
+        }
+        return result;
+    }
+    _doesPickUp(stopTime) {
+        if (stopTime.pickup_type === STOP_TIME_PICKUP_TYPE_REGULAR) {
+            return true;
+        }
+        else if (stopTime.pickup_type === STOP_TIME_PICKUP_TYPE_NO_PICKUP) {
+            return false;
+        }
+        else {
+            this._onError(new UnexpectedPickupTypeError(stopTime));
+            // If pickup_type is unexpected, let's just treat it like a normal stop. I
+            // don't think we need to exclude the whole trip for something as minor as
+            // mislabelling pick up only stops.
+            return true;
+        }
+    }
+    _doesDropOff(stopTime) {
+        if (stopTime.drop_off_type === STOP_TIME_DROP_OFF_TYPE_REGULAR) {
+            return true;
+        }
+        else if (stopTime.drop_off_type === STOP_TIME_DROP_OFF_TYPE_NO_DROP_OFF) {
+            return false;
+        }
+        else {
+            this._onError(new UnexpectedDropOffTypeError(stopTime));
+            // If drop_off_type is unexpected, let's just treat it like a normal stop.
+            // I don't think we need to exclude the whole trip for something as minor
+            // as mislabelling drop off only stops.
+            return true;
+        }
+    }
+}
+export class NoMatchingRouteError extends Error {
+    stopTimes;
+    resolvedStopIds;
+    type = "no-matching-route";
+    constructor(stopTimes, resolvedStopIds) {
+        super();
+        this.stopTimes = stopTimes;
+        this.resolvedStopIds = resolvedStopIds;
+    }
+}
+export class StopTimeReferencesUnmappedStopIdError extends Error {
+    stopTime;
+    type = "stop-time-references-unmapped-stop-id";
+    constructor(stopTime) {
+        super();
+        this.stopTime = stopTime;
+    }
+}
+export class UnexpectedPickupTypeError extends Error {
+    stopTime;
+    type = "unexpected-pickup-type";
+    constructor(stopTime) {
+        super();
+        this.stopTime = stopTime;
+    }
+}
+export class UnexpectedDropOffTypeError extends Error {
+    stopTime;
+    type = "unexpected-drop-off-type";
+    constructor(stopTime) {
+        super();
+        this.stopTime = stopTime;
+    }
+}
+//# sourceMappingURL=gtfs-route-matcher.js.map

package/dist/parser/schedule/gtfs-route-matcher.js.map

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

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

@@ -0,0 +1,15 @@
+import { GtfsScheduleData } from "../../data/gtfs-schedule-data.js";
+import { type GtfsCalendarParsingError } from "./gtfs-calendar-parser.js";
+import { type GtfsTripParsingError } from "./gtfs-trip-parser.js";
+import type { LineGtfsIdMapping } from "../../data/ids/line-gtfs-id-mapping.js";
+import type { StopGtfsIdMapping } from "../../data/ids/stop-gtfs-id-mapping.js";
+import type { LineRoutesMapping } from "../../data/route/line-routes-mapping.js";
+import type { BonusLinesMapping } from "../../data/route/bonus-lines-mapping.js";
+import type { GtfsFeedCsv } from "../../data/raw/schedule-csvs.js";
+export declare class GtfsScheduleParser {
+    private readonly _calendarParser;
+    private readonly _tripParser;
+    constructor(lineRoutesMapping: LineRoutesMapping, bonusLinesMapping: BonusLinesMapping, onError: (error: GtfsScheduleParsingError) => void);
+    parse(csvs: GtfsFeedCsv, lineGtfsIdMapping: LineGtfsIdMapping, stopGtfsIdMapping: StopGtfsIdMapping): GtfsScheduleData;
+}
+export type GtfsScheduleParsingError = GtfsCalendarParsingError | GtfsTripParsingError;

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

@@ -0,0 +1,19 @@
+import { GtfsScheduleData } from "../../data/gtfs-schedule-data.js";
+import { GtfsCalendarParser, } from "./gtfs-calendar-parser.js";
+import { GtfsTripParser, } from "./gtfs-trip-parser.js";
+// TODO: Rename GtfsScheduleDataParser.
+export class GtfsScheduleParser {
+    _calendarParser;
+    _tripParser;
+    constructor(lineRoutesMapping, bonusLinesMapping, onError) {
+        this._calendarParser = new GtfsCalendarParser(onError);
+        this._tripParser = new GtfsTripParser(lineRoutesMapping, bonusLinesMapping, onError);
+    }
+    parse(csvs, lineGtfsIdMapping, stopGtfsIdMapping) {
+        const { calendar, calendarDates, trips, stopTimes, transfers } = csvs;
+        const parsedCalendars = this._calendarParser.parse(calendar, calendarDates);
+        const parsedTrips = this._tripParser.parse(trips, stopTimes, transfers, parsedCalendars, lineGtfsIdMapping, stopGtfsIdMapping);
+        return new GtfsScheduleData(parsedTrips, parsedCalendars);
+    }
+}
+//# sourceMappingURL=gtfs-schedule-parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gtfs-schedule-parser.js","sourceRoot":"","sources":["../../../src/parser/schedule/gtfs-schedule-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EACL,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,GAEf,MAAM,uBAAuB,CAAC;AAO/B,uCAAuC;AACvC,MAAM,OAAO,kBAAkB;IACZ,eAAe,CAAqB;IACpC,WAAW,CAAiB;IAE7C,YACE,iBAAoC,EACpC,iBAAoC,EACpC,OAAkD;QAElD,IAAI,CAAC,eAAe,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,GAAG,IAAI,cAAc,CACnC,iBAAiB,EACjB,iBAAiB,EACjB,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CACH,IAAiB,EACjB,iBAAoC,EACpC,iBAAoC;QAEpC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAEtE,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAE5E,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CACxC,KAAK,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;QAEF,OAAO,IAAI,gBAAgB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/parser/schedule/gtfs-stop-time-normaliser.d.ts

@@ -0,0 +1,47 @@
+import type { StopTimesCsv } from "../../data/raw/schedule-csvs.js";
+/**
+ * Responsible for checking that in a list of stop times, the stop_sequence
+ * values start from 1 and increment by 1 each time. Where stop_sequence values
+ * are duplicated, this classes uses the earlier stop time for that stop. Any
+ * deviation from the incrementing pattern is reported and then rectified as
+ * best as possible.
+ */
+export declare class GtfsStopTimeNormaliser {
+    private readonly _onError;
+    constructor(_onError: (error: GtfsStopTimeNormalisationError) => void);
+    normalise(unsortedStopTimes: StopTimesCsv): StopTimesCsv | null;
+    /**
+     * Returns true if the stop times make a perfect sequence starting from 1, and
+     * is at least of length 2.
+     */
+    private _isRegular;
+    /**
+     * Returns true if the stop times (unsorted, so in the order given in
+     * stop_times.csv) form one or more regular sequences restarting at 1 each
+     * time. The only caveat is that all sequences must be at least of length 2.
+     *
+     * Valid:
+     * - `1, 2, 3, 4, 1, 2, 3`
+     *
+     * Invalid:
+     * - `1, 2, 3, 2, 3, 4`
+     * - `1, 2, 4, 5, 6, 1, 2`
+     * - `1, 2, 3, 1, 1, 2, 3`
+     * - `1`
+     * - `1, 1, 1`
+     */
+    private _isMultipleRegularSequences;
+    private _extractFirstRegularSequence;
+    private _requiresTimeTravelInFirstRegularSequence;
+}
+export type GtfsStopTimeNormalisationError = InvalidStopSequenceError | MultipleStopSequencesError;
+export declare class InvalidStopSequenceError extends Error {
+    readonly stopTimes: StopTimesCsv;
+    readonly type = "stop-sequence-duplicated";
+    constructor(stopTimes: StopTimesCsv);
+}
+export declare class MultipleStopSequencesError extends Error {
+    readonly stopTimes: StopTimesCsv;
+    readonly type = "multiple-stop-sequences";
+    constructor(stopTimes: StopTimesCsv);
+}

package/dist/parser/schedule/gtfs-stop-time-normaliser.js

@@ -0,0 +1,119 @@
+/**
+ * Responsible for checking that in a list of stop times, the stop_sequence
+ * values start from 1 and increment by 1 each time. Where stop_sequence values
+ * are duplicated, this classes uses the earlier stop time for that stop. Any
+ * deviation from the incrementing pattern is reported and then rectified as
+ * best as possible.
+ */
+export class GtfsStopTimeNormaliser {
+    _onError;
+    constructor(_onError) {
+        this._onError = _onError;
+    }
+    normalise(unsortedStopTimes) {
+        const sortedStopTimes = [...unsortedStopTimes].sort((a, b) => a.stop_sequence - b.stop_sequence);
+        if (this._isRegular(sortedStopTimes))
+            return sortedStopTimes;
+        // Sometimes we've seen trips in the regional feed where the rows are
+        // duplicated (sometimes with different arrival/departure times). In these
+        // cases, it seems like Google Maps just uses whichever sequence comes
+        // first, so that's what this code is doing.
+        //
+        // In an ideal future world, if we detect that both trips contain the same
+        // stops, we should use the earliest departure times for each stop to be
+        // pessimistic (and still show the other sequence of stopping times as a
+        // disruption about having ambiguous stopping times).
+        if (this._isMultipleRegularSequences(unsortedStopTimes)) {
+            this._onError(new MultipleStopSequencesError(unsortedStopTimes));
+            return this._extractFirstRegularSequence(unsortedStopTimes);
+        }
+        // Are there any other cases we can handle gracefully? I expect we might see
+        // some other cases pop up in the future, but this is all I know for now!
+        //
+        // ⚠️ IMPORTANT: This class is meant to output the stop times in the order
+        // they should be interpreted as for TrainQuery. It should NOT modify the
+        // stop_sequence values themselves (i.e. if there's gaps, leave them in)
+        // because we may need to use those when matching updates in the GTFS-RT
+        // feed to certain stops on the trip.
+        this._onError(new InvalidStopSequenceError(unsortedStopTimes));
+        return null;
+    }
+    /**
+     * Returns true if the stop times make a perfect sequence starting from 1, and
+     * is at least of length 2.
+     */
+    _isRegular(sortedStopTimes) {
+        return (sortedStopTimes.length >= 2 &&
+            sortedStopTimes.every((x, i) => x.stop_sequence === i + 1) &&
+            !this._requiresTimeTravelInFirstRegularSequence(sortedStopTimes));
+    }
+    /**
+     * Returns true if the stop times (unsorted, so in the order given in
+     * stop_times.csv) form one or more regular sequences restarting at 1 each
+     * time. The only caveat is that all sequences must be at least of length 2.
+     *
+     * Valid:
+     * - `1, 2, 3, 4, 1, 2, 3`
+     *
+     * Invalid:
+     * - `1, 2, 3, 2, 3, 4`
+     * - `1, 2, 4, 5, 6, 1, 2`
+     * - `1, 2, 3, 1, 1, 2, 3`
+     * - `1`
+     * - `1, 1, 1`
+     */
+    _isMultipleRegularSequences(unsortedStopTimes) {
+        let expectedStopSequence = 1;
+        for (const stopTime of unsortedStopTimes) {
+            if (stopTime.stop_sequence === expectedStopSequence) {
+                expectedStopSequence++;
+            }
+            else if (stopTime.stop_sequence === 1 && expectedStopSequence > 2) {
+                expectedStopSequence = 2;
+            }
+            else {
+                return false;
+            }
+        }
+        // If we left the loop where we'd next expect a 3 (or more), then we must've
+        // found (at least) 2 stops in the last sequence.
+        const lastSequenceHadAtLeastTwoStops = expectedStopSequence > 2;
+        return (lastSequenceHadAtLeastTwoStops &&
+            !this._requiresTimeTravelInFirstRegularSequence(unsortedStopTimes));
+    }
+    _extractFirstRegularSequence(stopTimes) {
+        return stopTimes.filter((x, i) => x.stop_sequence === i + 1);
+    }
+    _requiresTimeTravelInFirstRegularSequence(stopTimes) {
+        return stopTimes.some((x, i) => {
+            // We're ignoring everything after the first regular sequence.
+            if (x.stop_sequence !== i + 1)
+                return false;
+            if (x.arrival_time.isAfter(x.departure_time))
+                return true;
+            const previousStopTime = stopTimes[i - 1];
+            if (previousStopTime != null &&
+                previousStopTime.departure_time.isAfter(x.arrival_time)) {
+                return true;
+            }
+            return false;
+        });
+    }
+}
+export class InvalidStopSequenceError extends Error {
+    stopTimes;
+    type = "stop-sequence-duplicated";
+    constructor(stopTimes) {
+        super();
+        this.stopTimes = stopTimes;
+    }
+}
+export class MultipleStopSequencesError extends Error {
+    stopTimes;
+    type = "multiple-stop-sequences";
+    constructor(stopTimes) {
+        super();
+        this.stopTimes = stopTimes;
+    }
+}
+//# sourceMappingURL=gtfs-stop-time-normaliser.js.map

package/dist/parser/schedule/gtfs-stop-time-normaliser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtfs-stop-time-normaliser.js","sourceRoot":"","sources":["../../../src/parser/schedule/gtfs-stop-time-normaliser.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IAEd;IADnB,YACmB,QAAyD;QAAzD,aAAQ,GAAR,QAAQ,CAAiD;IACzE,CAAC;IAEJ,SAAS,CAAC,iBAA+B;QACvC,MAAM,eAAe,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAC5C,CAAC;QAEF,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;YAAE,OAAO,eAAe,CAAC;QAE7D,qEAAqE;QACrE,0EAA0E;QAC1E,sEAAsE;QACtE,4CAA4C;QAC5C,EAAE;QACF,0EAA0E;QAC1E,wEAAwE;QACxE,wEAAwE;QACxE,qDAAqD;QACrD,IAAI,IAAI,CAAC,2BAA2B,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,0BAA0B,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAEjE,OAAO,IAAI,CAAC,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;QAC9D,CAAC;QAED,4EAA4E;QAC5E,yEAAyE;QACzE,EAAE;QACF,0EAA0E;QAC1E,yEAAyE;QACzE,wEAAwE;QACxE,wEAAwE;QACxE,qCAAqC;QACrC,IAAI,CAAC,QAAQ,CAAC,IAAI,wBAAwB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,eAA6B;QAC9C,OAAO,CACL,eAAe,CAAC,MAAM,IAAI,CAAC;YAC3B,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1D,CAAC,IAAI,CAAC,yCAAyC,CAAC,eAAe,CAAC,CACjE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACK,2BAA2B,CACjC,iBAA+B;QAE/B,IAAI,oBAAoB,GAAG,CAAC,CAAC;QAC7B,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;YACzC,IAAI,QAAQ,CAAC,aAAa,KAAK,oBAAoB,EAAE,CAAC;gBACpD,oBAAoB,EAAE,CAAC;YACzB,CAAC;iBAAM,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC,IAAI,oBAAoB,GAAG,CAAC,EAAE,CAAC;gBACpE,oBAAoB,GAAG,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,iDAAiD;QACjD,MAAM,8BAA8B,GAAG,oBAAoB,GAAG,CAAC,CAAC;QAEhE,OAAO,CACL,8BAA8B;YAC9B,CAAC,IAAI,CAAC,yCAAyC,CAAC,iBAAiB,CAAC,CACnE,CAAC;IACJ,CAAC;IAEO,4BAA4B,CAAC,SAAuB;QAC1D,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEO,yCAAyC,CAC/C,SAAuB;QAEvB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,8DAA8D;YAC9D,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YAE5C,IAAI,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAC;YAE1D,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAE1C,IACE,gBAAgB,IAAI,IAAI;gBACxB,gBAAgB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,EACvD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAMD,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAE5B;IADZ,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAqB,SAAuB;QAC1C,KAAK,EAAE,CAAC;QADW,cAAS,GAAT,SAAS,CAAc;IAE5C,CAAC;CAKF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAE9B;IADZ,IAAI,GAAG,yBAAyB,CAAC;IAC1C,YAAqB,SAAuB;QAC1C,KAAK,EAAE,CAAC;QADW,cAAS,GAAT,SAAS,CAAc;IAE5C,CAAC;CACF"}

package/dist/parser/schedule/gtfs-transfer-connector.d.ts

@@ -0,0 +1,52 @@
+import type { TransfersCsv, TransfersCsvRow } from "../../data/raw/schedule-csvs.js";
+import { GtfsScheduledTrip } from "../../data/gtfs-scheduled-trip.js";
+export declare class GtfsTransferConnector {
+    private readonly _onError;
+    constructor(_onError: (error: GtfsTransferConnectionError) => void);
+    connect(trips: readonly GtfsScheduledTrip[], transfers: TransfersCsv): readonly GtfsScheduledTrip[];
+}
+export type GtfsTransferConnectionError = TransferReferencesNonExistentTrip | TransferIsNotFromTerminusError | TransferIsNotToOriginError | TransferReferencesTripAlreadyConnectedError | TransferIsNotInSeatTransferError | TransferIsNotSameStopAndPositionError | TransferCrossesCalendarsError | TransferRequiresTimeTravelError;
+export declare class TransferReferencesNonExistentTrip extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly field: "from_trip_id" | "to_trip_id";
+    readonly type = "transfer-references-non-existent-trip";
+    constructor(transfer: TransfersCsvRow, field: "from_trip_id" | "to_trip_id");
+}
+export declare class TransferIsNotFromTerminusError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly fromTrip: GtfsScheduledTrip;
+    readonly type = "transfer-is-not-from-terminus";
+    constructor(transfer: TransfersCsvRow, fromTrip: GtfsScheduledTrip);
+}
+export declare class TransferIsNotToOriginError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly toTrip: GtfsScheduledTrip;
+    readonly type = "transfer-is-not-to-origin";
+    constructor(transfer: TransfersCsvRow, toTrip: GtfsScheduledTrip);
+}
+export declare class TransferReferencesTripAlreadyConnectedError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly tripWithExistingConnection: GtfsScheduledTrip;
+    readonly type = "transfer-references-trip-already-connected";
+    constructor(transfer: TransfersCsvRow, tripWithExistingConnection: GtfsScheduledTrip);
+}
+export declare class TransferIsNotInSeatTransferError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly type = "transfer-is-not-in-seat-transfer";
+    constructor(transfer: TransfersCsvRow);
+}
+export declare class TransferIsNotSameStopAndPositionError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly type = "transfer-is-not-same-stop-and-position";
+    constructor(transfer: TransfersCsvRow);
+}
+export declare class TransferCrossesCalendarsError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly type = "transfer-crosses-calendars";
+    constructor(transfer: TransfersCsvRow);
+}
+export declare class TransferRequiresTimeTravelError extends Error {
+    readonly transfer: TransfersCsvRow;
+    readonly type = "transfer-requires-time-travel";
+    constructor(transfer: TransfersCsvRow);
+}