corequery-gtfs 0.1.0 → 0.1.2

package/dist/parser/realtime/gtfs-trip-update-parser.d.ts

@@ -0,0 +1,99 @@
+import type { GtfsScheduleData } from "../../data/gtfs-schedule-data.js";
+import type { GtfsScheduledTrip } from "../../data/gtfs-scheduled-trip.js";
+import { GtfsUpdatedTrip } from "../../data/gtfs-updated-trip.js";
+import type { StopTimeUpdateJson, TripUpdateJson, UpdatedTimeJson } from "../../data/raw/realtime-data-json.js";
+import { type GtfsTripUpdateTripIdentificationError } from "./gtfs-trip-update-trip-identifier.js";
+import type { StopGtfsIdMapping } from "../../data/ids/stop-gtfs-id-mapping.js";
+export declare class GtfsTripUpdateParser {
+    private readonly _timezone;
+    private readonly _onError;
+    private readonly _tripIdentifier;
+    constructor(_timezone: string, _onError: (error: GtfsTripUpdateParsingError) => void);
+    parse(tripUpdate: TripUpdateJson, scheduleData: GtfsScheduleData, stopGtfsIdMapping: StopGtfsIdMapping): GtfsUpdatedTrip | null;
+    private _parseForScheduledTrip;
+    private _parseForCancelledTrip;
+    private _parseUpdatedTime;
+}
+export type GtfsTripUpdateParsingError = UnsupportedTripUpdateScheduleRelationshipError | GtfsTripUpdateTripIdentificationError | NoStopTimeUpdateFieldGivenError | UnsupportedStopTimeUpdateEntryScheduleRelationshipError | NecessaryFieldNotInStopTimeUpdateEntryError | StopTimeUpdateEntryReferencesNonExistentStopSequenceError | MultipleStopTimeUpdateEntriesForSameMovementIndexError | StopTimeUpdateEntryReferencesUnmappedStopIdError | StopTimeUpdateEntryChangesStopError | StopTimeUpdateEntryChangesPlatformError | NeitherTimeNorDelayGivenError | TimeAndDelayDisagreeWithEachOtherError | NeitherArrivalNorDepartureGivenError;
+export declare class UnsupportedTripUpdateScheduleRelationshipError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly type = "unsupported-trip-update-schedule-relationship";
+    constructor(tripUpdate: TripUpdateJson);
+}
+export declare class NoStopTimeUpdateFieldGivenError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly type = "no-stop-time-update-field-given";
+    constructor(tripUpdate: TripUpdateJson);
+}
+export declare class UnsupportedStopTimeUpdateEntryScheduleRelationshipError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly type = "unsupported-stop-time-update-entry-schedule-relationship";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson);
+}
+export declare class NecessaryFieldNotInStopTimeUpdateEntryError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly field: "stopSequence" | "stopId";
+    readonly type = "necessary-field-not-in-stop-time-update-entry";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, field: "stopSequence" | "stopId");
+}
+export declare class StopTimeUpdateEntryReferencesNonExistentStopSequenceError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly matchedTrip: GtfsScheduledTrip;
+    readonly type = "stop-time-update-entry-references-non-existent-stop-sequence";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, matchedTrip: GtfsScheduledTrip);
+}
+export declare class MultipleStopTimeUpdateEntriesForSameMovementIndexError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly matchedTrip: GtfsScheduledTrip;
+    readonly matchedMovementIndex: number;
+    readonly type = "multiple-stop-time-update-entries-for-same-movement-index";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, matchedTrip: GtfsScheduledTrip, matchedMovementIndex: number);
+}
+export declare class StopTimeUpdateEntryReferencesUnmappedStopIdError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly type = "stop-time-update-entry-references-unmapped-stop-id";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson);
+}
+export declare class StopTimeUpdateEntryChangesStopError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly matchedTrip: GtfsScheduledTrip;
+    readonly matchedMovementIndex: number;
+    readonly type = "stop-time-update-entry-changes-stop";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, matchedTrip: GtfsScheduledTrip, matchedMovementIndex: number);
+}
+export declare class StopTimeUpdateEntryChangesPlatformError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly matchedTrip: GtfsScheduledTrip;
+    readonly matchedMovementIndex: number;
+    readonly type = "stop-time-update-entry-changes-platform";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, matchedTrip: GtfsScheduledTrip, matchedMovementIndex: number);
+}
+export declare class NeitherTimeNorDelayGivenError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly updatedTime: UpdatedTimeJson;
+    readonly type = "neither-time-nor-delay-given";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, updatedTime: UpdatedTimeJson);
+}
+export declare class TimeAndDelayDisagreeWithEachOtherError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly updatedTime: UpdatedTimeJson;
+    readonly parsedFromTime: Temporal.Instant;
+    readonly parsedFromDelay: Temporal.Instant;
+    readonly type = "time-and-delay-disagree-with-each-other";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson, updatedTime: UpdatedTimeJson, parsedFromTime: Temporal.Instant, parsedFromDelay: Temporal.Instant);
+}
+export declare class NeitherArrivalNorDepartureGivenError extends Error {
+    readonly tripUpdate: TripUpdateJson;
+    readonly stopTimeUpdateEntry: StopTimeUpdateJson;
+    readonly type = "neither-arrival-nor-departure-given";
+    constructor(tripUpdate: TripUpdateJson, stopTimeUpdateEntry: StopTimeUpdateJson);
+}

package/dist/parser/realtime/gtfs-trip-update-parser.js

@@ -0,0 +1,335 @@
+import { GtfsUpdatedTrip } from "../../data/gtfs-updated-trip.js";
+import { GtfsTripUpdateTripIdentifier, } from "./gtfs-trip-update-trip-identifier.js";
+import { itsOk } from "@dan-schel/js-utils";
+const TRIP_UPDATE_SCHEDULE_RELATIONSHIP_SCHEDULED = "SCHEDULED";
+const TRIP_UPDATE_SCHEDULE_RELATIONSHIP_CANCELLED = "CANCELED";
+const STOP_TIME_UPDATE_ENTRY_SCHEDULE_RELATIONSHIP_SCHEDULED = "SCHEDULED";
+export class GtfsTripUpdateParser {
+    _timezone;
+    _onError;
+    _tripIdentifier;
+    constructor(
+    // We could maybe store this in the GtfsSchedule obj itself if we wanted,
+    // since you can parse it from agency.txt.
+    _timezone, _onError) {
+        this._timezone = _timezone;
+        this._onError = _onError;
+        this._tripIdentifier = new GtfsTripUpdateTripIdentifier(_onError);
+    }
+    parse(tripUpdate, scheduleData, stopGtfsIdMapping) {
+        const sr = tripUpdate.trip.scheduleRelationship;
+        if (sr === TRIP_UPDATE_SCHEDULE_RELATIONSHIP_SCHEDULED) {
+            return this._parseForScheduledTrip(tripUpdate, scheduleData, stopGtfsIdMapping);
+        }
+        else if (sr === TRIP_UPDATE_SCHEDULE_RELATIONSHIP_CANCELLED) {
+            return this._parseForCancelledTrip(tripUpdate, scheduleData);
+        }
+        else {
+            this._onError(new UnsupportedTripUpdateScheduleRelationshipError(tripUpdate));
+            return null;
+        }
+    }
+    _parseForScheduledTrip(tripUpdate, scheduleData, stopGtfsIdMapping) {
+        const result = this._tripIdentifier.identify(tripUpdate.trip, scheduleData);
+        if (result == null)
+            return null;
+        const { trip, serviceDay } = result;
+        if (tripUpdate.stopTimeUpdate == null) {
+            this._onError(new NoStopTimeUpdateFieldGivenError(tripUpdate));
+            return null;
+        }
+        const updatedMovementsByIndex = new Map();
+        for (const entry of tripUpdate.stopTimeUpdate) {
+            // This `scheduleRelationship` field is probably how altered routes work.
+            const sr = entry.scheduleRelationship;
+            if (sr !== STOP_TIME_UPDATE_ENTRY_SCHEDULE_RELATIONSHIP_SCHEDULED) {
+                const Err = UnsupportedStopTimeUpdateEntryScheduleRelationshipError;
+                this._onError(new Err(tripUpdate, entry));
+                return null;
+            }
+            // Check the fields we're gonna rely on (that PTV seems to reliably give
+            // but are technically optional in the GTFS-RT spec) are actually present.
+            if (entry.stopSequence == null) {
+                const Err = NecessaryFieldNotInStopTimeUpdateEntryError;
+                this._onError(new Err(tripUpdate, entry, "stopSequence"));
+                return null;
+            }
+            if (entry.stopId == null) {
+                const Err = NecessaryFieldNotInStopTimeUpdateEntryError;
+                this._onError(new Err(tripUpdate, entry, "stopId"));
+                return null;
+            }
+            if (entry.arrival == null && entry.departure == null) {
+                const Err = NeitherArrivalNorDepartureGivenError;
+                this._onError(new Err(tripUpdate, entry));
+                return null;
+            }
+            // Find the stop in the scheduled trip that this update is supposed to be
+            // for.
+            const movementIndex = trip.movements.findIndex((m) => m.isServicing && m.gtfsStopSequence === entry.stopSequence);
+            if (movementIndex === -1) {
+                const Err = StopTimeUpdateEntryReferencesNonExistentStopSequenceError;
+                this._onError(new Err(tripUpdate, entry, trip));
+                return null;
+            }
+            // Enforced by findIndex above.
+            const scheduledMovement = itsOk(trip.movements[movementIndex]);
+            if (!scheduledMovement.isServicing)
+                throw new Error();
+            // Check that we haven't already matched a stop time update entry to this
+            // movement index. (Would happen if `stopSequence` was the same value
+            // twice, I guess.)
+            if (updatedMovementsByIndex.has(movementIndex)) {
+                const Err = MultipleStopTimeUpdateEntriesForSameMovementIndexError;
+                this._onError(new Err(tripUpdate, entry, trip, movementIndex));
+                return null;
+            }
+            // Look up the stop GTFS ID given in the stop time update entry, and check
+            // whether it still maps to the same (CoreQuery) stop. In this way, we
+            // allow the platform/position ID to change, not the overall stop/station.
+            const gtfsIdMetadata = stopGtfsIdMapping.tryResolve(entry.stopId);
+            if (gtfsIdMetadata == null) {
+                const Err = StopTimeUpdateEntryReferencesUnmappedStopIdError;
+                this._onError(new Err(tripUpdate, entry));
+                return null;
+            }
+            if (gtfsIdMetadata.stopId !== scheduledMovement.gtfsIdMetadata.stopId) {
+                const Err = StopTimeUpdateEntryChangesStopError;
+                this._onError(new Err(tripUpdate, entry, trip, movementIndex));
+                return null;
+            }
+            // This is not really an error (note that I don't return null!), it's just
+            // logging to see if it ever happens. We support platform changes done in
+            // this way, but I built that support on assumptions, and I have no idea
+            // if this is typically how PTV would represent a platform change.
+            if (gtfsIdMetadata.id !== scheduledMovement.gtfsIdMetadata.id) {
+                const Err = StopTimeUpdateEntryChangesPlatformError;
+                this._onError(new Err(tripUpdate, entry, trip, movementIndex));
+            }
+            const updatedPositionId = gtfsIdMetadata.type === "platform" ? gtfsIdMetadata.positionId : null;
+            // Parse the updated times from the `arrivalTime` and `departureTime`
+            // fields.
+            const realtimeArrivalTime = "arrivalTime" in scheduledMovement
+                ? this._parseUpdatedTime(entry.arrival ?? null, scheduledMovement.arrivalTime, serviceDay, tripUpdate, entry)
+                : null;
+            const realtimeDepartureTime = "departureTime" in scheduledMovement
+                ? this._parseUpdatedTime(entry.departure ?? null, scheduledMovement.departureTime, serviceDay, tripUpdate, entry)
+                : null;
+            updatedMovementsByIndex.set(movementIndex, scheduledMovement.asUpdatedTripMovement({
+                arrivalTime: realtimeArrivalTime,
+                departureTime: realtimeDepartureTime,
+                updatedPositionId,
+                updatedGtfsIdMetadata: gtfsIdMetadata,
+                serviceDay,
+                timezone: this._timezone,
+            }));
+        }
+        let movements = trip.movements.map((m) => m.asHollowUpdatedTripMovement(serviceDay, this._timezone));
+        movements = movements.map((movement, i) => {
+            return updatedMovementsByIndex.get(i) ?? movement;
+        });
+        return new GtfsUpdatedTrip({
+            scheduledTrip: trip,
+            serviceDay,
+            movements,
+            isCancelled: false,
+        });
+    }
+    _parseForCancelledTrip(tripUpdate, scheduleData) {
+        const result = this._tripIdentifier.identify(tripUpdate.trip, scheduleData);
+        if (result == null)
+            return null;
+        const { trip, serviceDay } = result;
+        return GtfsUpdatedTrip.unmodified(trip, serviceDay, this._timezone).with({
+            isCancelled: true,
+        });
+    }
+    _parseUpdatedTime(updatedTime, scheduledTime, serviceDay, tripUpdate, stopTimeUpdateEntry) {
+        if (updatedTime == null) {
+            return null;
+        }
+        const { time, delay } = updatedTime;
+        const fromTime = time != null ? Temporal.Instant.fromEpochMilliseconds(time * 1000) : null;
+        const fromDelay = delay != null
+            ? scheduledTime
+                .toInstant(serviceDay, this._timezone)
+                .add({ seconds: delay })
+            : null;
+        // Most/all trips in PTV's realtime feed have both time and delay. If using
+        // both of those methods gives us different results, then I've probably
+        // messed something up (e.g. maybe my service day assumption in the trip
+        // identifier is wrong)... or PTV has.
+        //
+        // We'll press on (this check is only meant for reporting/my interest), but
+        // the something's probably gonna be very broken for this trip!
+        if (fromTime != null && fromDelay != null && !fromTime.equals(fromDelay)) {
+            this._onError(new TimeAndDelayDisagreeWithEachOtherError(tripUpdate, stopTimeUpdateEntry, updatedTime, fromTime, fromDelay));
+        }
+        // I don't think it really matters which of `delay` or `time` we preference,
+        // since they're either identical, or we've (probably) messed up the service
+        // day, in which case we're either applying the right time to the wrong
+        // service (`time`), or the we've calculated the time assuming the wrong
+        // service day (`delay`).
+        //
+        // It'll probably be clearer to me trying to debug this if we apply this
+        // realtime update to yesterday/tomorrow's service and it makes it look like
+        // there's two departures of the same service happening at/near to the same
+        // time, so I'll pick `time`.
+        if (fromTime != null) {
+            return fromTime;
+        }
+        else if (fromDelay != null) {
+            return fromDelay;
+        }
+        else {
+            const Err = NeitherTimeNorDelayGivenError;
+            this._onError(new Err(tripUpdate, stopTimeUpdateEntry, updatedTime));
+            return null;
+        }
+    }
+}
+export class UnsupportedTripUpdateScheduleRelationshipError extends Error {
+    tripUpdate;
+    type = "unsupported-trip-update-schedule-relationship";
+    constructor(tripUpdate) {
+        super();
+        this.tripUpdate = tripUpdate;
+    }
+}
+export class NoStopTimeUpdateFieldGivenError extends Error {
+    tripUpdate;
+    type = "no-stop-time-update-field-given";
+    constructor(tripUpdate) {
+        super();
+        this.tripUpdate = tripUpdate;
+    }
+}
+export class UnsupportedStopTimeUpdateEntryScheduleRelationshipError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    type = "unsupported-stop-time-update-entry-schedule-relationship";
+    constructor(tripUpdate, stopTimeUpdateEntry) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+    }
+}
+export class NecessaryFieldNotInStopTimeUpdateEntryError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    field;
+    type = "necessary-field-not-in-stop-time-update-entry";
+    constructor(tripUpdate, stopTimeUpdateEntry, field) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.field = field;
+    }
+}
+export class StopTimeUpdateEntryReferencesNonExistentStopSequenceError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    matchedTrip;
+    type = "stop-time-update-entry-references-non-existent-stop-sequence";
+    constructor(tripUpdate, stopTimeUpdateEntry, matchedTrip) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.matchedTrip = matchedTrip;
+    }
+}
+export class MultipleStopTimeUpdateEntriesForSameMovementIndexError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    matchedTrip;
+    matchedMovementIndex;
+    type = "multiple-stop-time-update-entries-for-same-movement-index";
+    constructor(tripUpdate, stopTimeUpdateEntry, matchedTrip, matchedMovementIndex) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.matchedTrip = matchedTrip;
+        this.matchedMovementIndex = matchedMovementIndex;
+    }
+}
+export class StopTimeUpdateEntryReferencesUnmappedStopIdError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    type = "stop-time-update-entry-references-unmapped-stop-id";
+    constructor(tripUpdate, stopTimeUpdateEntry) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+    }
+}
+// i.e. It doesn't just change the platform (which we're fine with), but the
+// entire stop.
+export class StopTimeUpdateEntryChangesStopError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    matchedTrip;
+    matchedMovementIndex;
+    type = "stop-time-update-entry-changes-stop";
+    constructor(tripUpdate, stopTimeUpdateEntry, matchedTrip, matchedMovementIndex) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.matchedTrip = matchedTrip;
+        this.matchedMovementIndex = matchedMovementIndex;
+    }
+}
+// Just logging this to see if it ever happens. It's not really an error, and we
+// handle it well.
+export class StopTimeUpdateEntryChangesPlatformError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    matchedTrip;
+    matchedMovementIndex;
+    type = "stop-time-update-entry-changes-platform";
+    constructor(tripUpdate, stopTimeUpdateEntry, matchedTrip, matchedMovementIndex) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.matchedTrip = matchedTrip;
+        this.matchedMovementIndex = matchedMovementIndex;
+    }
+}
+export class NeitherTimeNorDelayGivenError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    updatedTime;
+    type = "neither-time-nor-delay-given";
+    constructor(tripUpdate, stopTimeUpdateEntry, updatedTime) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.updatedTime = updatedTime;
+    }
+}
+export class TimeAndDelayDisagreeWithEachOtherError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    updatedTime;
+    parsedFromTime;
+    parsedFromDelay;
+    type = "time-and-delay-disagree-with-each-other";
+    constructor(tripUpdate, stopTimeUpdateEntry, updatedTime, parsedFromTime, parsedFromDelay) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+        this.updatedTime = updatedTime;
+        this.parsedFromTime = parsedFromTime;
+        this.parsedFromDelay = parsedFromDelay;
+    }
+}
+export class NeitherArrivalNorDepartureGivenError extends Error {
+    tripUpdate;
+    stopTimeUpdateEntry;
+    type = "neither-arrival-nor-departure-given";
+    constructor(tripUpdate, stopTimeUpdateEntry) {
+        super();
+        this.tripUpdate = tripUpdate;
+        this.stopTimeUpdateEntry = stopTimeUpdateEntry;
+    }
+}
+//# sourceMappingURL=gtfs-trip-update-parser.js.map

package/dist/parser/realtime/gtfs-trip-update-parser.js.map

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

package/dist/parser/realtime/gtfs-trip-update-trip-identifier.d.ts

@@ -0,0 +1,35 @@
+import type { GtfsScheduleData } from "../../data/gtfs-schedule-data.js";
+import type { GtfsScheduledTrip } from "../../data/gtfs-scheduled-trip.js";
+import type { TripDescriptorJson } from "../../data/raw/realtime-data-json.js";
+export declare class GtfsTripUpdateTripIdentifier {
+    private readonly _onError;
+    constructor(_onError: (error: GtfsTripUpdateTripIdentificationError) => void);
+    identify(tripDescriptor: TripDescriptorJson, scheduleData: GtfsScheduleData): {
+        trip: GtfsScheduledTrip;
+        serviceDay: Temporal.PlainDate;
+    } | null;
+}
+export type GtfsTripUpdateTripIdentificationError = NecessaryFieldNotInTripDescriptorError | TripDescriptorReferencesNonExistentTripIdError | TripDoesNotOccurOnStartDateError | TripDescriptorStartTimeDoesNotMatchTripOriginStopTimeError;
+export declare class NecessaryFieldNotInTripDescriptorError extends Error {
+    readonly tripDescriptor: TripDescriptorJson;
+    readonly field: "tripId" | "startDate";
+    readonly type = "necessary-field-not-in-trip-descriptor";
+    constructor(tripDescriptor: TripDescriptorJson, field: "tripId" | "startDate");
+}
+export declare class TripDescriptorReferencesNonExistentTripIdError extends Error {
+    readonly tripDescriptor: TripDescriptorJson;
+    readonly type = "trip-descriptor-references-non-existent-trip-id";
+    constructor(tripDescriptor: TripDescriptorJson);
+}
+export declare class TripDoesNotOccurOnStartDateError extends Error {
+    readonly tripDescriptor: TripDescriptorJson;
+    readonly trip: GtfsScheduledTrip;
+    readonly type = "trip-does-not-occur-on-start-date";
+    constructor(tripDescriptor: TripDescriptorJson, trip: GtfsScheduledTrip);
+}
+export declare class TripDescriptorStartTimeDoesNotMatchTripOriginStopTimeError extends Error {
+    readonly tripDescriptor: TripDescriptorJson;
+    readonly trip: GtfsScheduledTrip;
+    readonly type = "trip-descriptor-start-time-does-not-match-trip-origin-stop-time";
+    constructor(tripDescriptor: TripDescriptorJson, trip: GtfsScheduledTrip);
+}

package/dist/parser/realtime/gtfs-trip-update-trip-identifier.js

@@ -0,0 +1,95 @@
+export class GtfsTripUpdateTripIdentifier {
+    _onError;
+    constructor(_onError) {
+        this._onError = _onError;
+    }
+    identify(tripDescriptor, scheduleData) {
+        // Currently it seems like PTV always gives `tripId` and `startDate` in the
+        // trip descriptor, even though the GTFS-RT spec allows other methods of
+        // identifying the trip. We'll rely on them being present unless it later
+        // turns out we can't.
+        if (tripDescriptor.tripId == null) {
+            const Err = NecessaryFieldNotInTripDescriptorError;
+            this._onError(new Err(tripDescriptor, "tripId"));
+            return null;
+        }
+        if (tripDescriptor.startDate == null) {
+            const Err = NecessaryFieldNotInTripDescriptorError;
+            this._onError(new Err(tripDescriptor, "startDate"));
+            return null;
+        }
+        const trip = scheduleData.getTrip(tripDescriptor.tripId);
+        // TODO: We filter out trips from replacement bus services, so if we ever
+        // got a trip update for a replacement bus it would trigger this error, but
+        // we should probably ignore that case.
+        if (trip == null) {
+            const Err = TripDescriptorReferencesNonExistentTripIdError;
+            this._onError(new Err(tripDescriptor));
+            return null;
+        }
+        // It's unclear to me whether the startDate in GTFS-RT is meant to be the
+        // "service day" of the trip, or just the calendar date of the first stop.
+        // I'm assuming it's the service date for now, since startTime can exceed
+        // 24:00:00, so they probably work together as a pair to be consistent with
+        // the GTFS schedule representation.
+        //
+        // If this error ever fires, it indicates that that assumption is incorrect!
+        // (Or that PTV made a mistake I guess.)
+        if (!trip.calendar.occursOn(tripDescriptor.startDate)) {
+            this._onError(new TripDoesNotOccurOnStartDateError(tripDescriptor, trip));
+            return null;
+        }
+        // If a startTime is given, check that it matches the trip we've identified.
+        // If it doesn't, it might indicate a bug with our matching logic. For now,
+        // I've decided only to report it rather than return null, but idk, this
+        // might be a strong enough case to say we've matched incorrectly.
+        if (tripDescriptor.startTime != null &&
+            !tripDescriptor.startTime.equals(trip.origination.departureTime)) {
+            const Err = TripDescriptorStartTimeDoesNotMatchTripOriginStopTimeError;
+            this._onError(new Err(tripDescriptor, trip));
+        }
+        return { trip, serviceDay: tripDescriptor.startDate };
+    }
+}
+// Naming "necessary" rather that "required" since "required" implies that it
+// breaks the GTFS-RT spec, but in reality it's just that we don't support other
+// methods of identifying the trip yet.
+export class NecessaryFieldNotInTripDescriptorError extends Error {
+    tripDescriptor;
+    field;
+    type = "necessary-field-not-in-trip-descriptor";
+    constructor(tripDescriptor, field) {
+        super();
+        this.tripDescriptor = tripDescriptor;
+        this.field = field;
+    }
+}
+export class TripDescriptorReferencesNonExistentTripIdError extends Error {
+    tripDescriptor;
+    type = "trip-descriptor-references-non-existent-trip-id";
+    constructor(tripDescriptor) {
+        super();
+        this.tripDescriptor = tripDescriptor;
+    }
+}
+export class TripDoesNotOccurOnStartDateError extends Error {
+    tripDescriptor;
+    trip;
+    type = "trip-does-not-occur-on-start-date";
+    constructor(tripDescriptor, trip) {
+        super();
+        this.tripDescriptor = tripDescriptor;
+        this.trip = trip;
+    }
+}
+export class TripDescriptorStartTimeDoesNotMatchTripOriginStopTimeError extends Error {
+    tripDescriptor;
+    trip;
+    type = "trip-descriptor-start-time-does-not-match-trip-origin-stop-time";
+    constructor(tripDescriptor, trip) {
+        super();
+        this.tripDescriptor = tripDescriptor;
+        this.trip = trip;
+    }
+}
+//# sourceMappingURL=gtfs-trip-update-trip-identifier.js.map

package/dist/parser/realtime/gtfs-trip-update-trip-identifier.js.map

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

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

@@ -0,0 +1,3 @@
+export type { GtfsRealtimeDataParsingError } from "./gtfs-realtime-data-parser.js";
+export type { GtfsTripUpdateParsingError, UnsupportedTripUpdateScheduleRelationshipError, NoStopTimeUpdateFieldGivenError, UnsupportedStopTimeUpdateEntryScheduleRelationshipError, NecessaryFieldNotInStopTimeUpdateEntryError, StopTimeUpdateEntryReferencesNonExistentStopSequenceError, MultipleStopTimeUpdateEntriesForSameMovementIndexError, StopTimeUpdateEntryReferencesUnmappedStopIdError, StopTimeUpdateEntryChangesStopError, StopTimeUpdateEntryChangesPlatformError, NeitherTimeNorDelayGivenError, TimeAndDelayDisagreeWithEachOtherError, NeitherArrivalNorDepartureGivenError, } from "./gtfs-trip-update-parser.js";
+export type { GtfsTripUpdateTripIdentificationError, NecessaryFieldNotInTripDescriptorError, TripDescriptorReferencesNonExistentTripIdError, TripDoesNotOccurOnStartDateError, TripDescriptorStartTimeDoesNotMatchTripOriginStopTimeError, } from "./gtfs-trip-update-trip-identifier.js";

package/dist/parser/realtime/index.js

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

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

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

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

@@ -0,0 +1,28 @@
+import type { CalendarCsv, CalendarCsvRow, CalendarDatesCsv, CalendarDatesCsvRow } from "../../data/raw/schedule-csvs.js";
+import { GtfsCalendar } from "../../data/gtfs-calendar.js";
+export declare class GtfsCalendarParser {
+    private readonly _onError;
+    constructor(_onError: (error: GtfsCalendarParsingError) => void);
+    parse(calendarCsv: CalendarCsv, calendarDatesCsv: CalendarDatesCsv): readonly GtfsCalendar[];
+}
+export type GtfsCalendarParsingError = DuplicateCalendarIdError | UnexpectedCalendarDateExceptionTypeError | InvalidCalendarDateRangeError | MultipleExceptionsForSameDateError;
+export declare class DuplicateCalendarIdError extends Error {
+    readonly subsequentRowWithDuplicateId: CalendarCsvRow;
+    readonly type = "duplicate-calendar";
+    constructor(subsequentRowWithDuplicateId: CalendarCsvRow);
+}
+export declare class InvalidCalendarDateRangeError extends Error {
+    readonly row: CalendarCsvRow;
+    readonly type = "invalid-calendar-date-range";
+    constructor(row: CalendarCsvRow);
+}
+export declare class UnexpectedCalendarDateExceptionTypeError extends Error {
+    readonly row: CalendarDatesCsvRow;
+    readonly type = "unexpected-calendar-date-exception-type";
+    constructor(row: CalendarDatesCsvRow);
+}
+export declare class MultipleExceptionsForSameDateError extends Error {
+    readonly subsequentRowForSameDate: CalendarDatesCsvRow;
+    readonly type = "multiple-exceptions-for-same-date";
+    constructor(subsequentRowForSameDate: CalendarDatesCsvRow);
+}