@tiducto/spider-sdk-typescript 0.1.1 → 1.0.0

package/dist/index.js

@@ -1,8 +1,7 @@
 export { SpiderClient } from "./client.js";
-export { SpiderContractMismatchError } from "./errors.js";
 export { Location, ViaLocation } from "./location.js";
 export { SpiderRouting } from "./routing.js";
 export { SpiderStops } from "./stops.js";
-export { SpiderRealtime } from "./realtime.js";
+export { SpiderRealtime, delayFor } from "./realtime.js";
 export { pollVehicles, pollVehicleForTrip, pollDelays, pollAlerts } from "./polling.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAc/C,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAUtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAezD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/location.d.ts

@@ -18,6 +18,10 @@ export type ViaLocation = {
     readonly location: Location;
     readonly minimumWaitSeconds: number;
 };
+/**
+ * A point the itinerary must pass. How many a request may carry is an environment setting; each pass-through takes
+ * 1 to 10 stop ids and a visit waits 0 to 86400 seconds, else the request fails as `bad_request` on `via`.
+ */
 export declare const ViaLocation: {
     readonly passThrough: (...stopIds: string[]) => ViaLocation;
     readonly visit: (location: Location, minimumWaitSeconds?: number) => ViaLocation;

package/dist/location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../src/location.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,eAAO,MAAM,QAAQ;oCACE,MAAM,aAAa,MAAM,KAAG,QAAQ;wBAGhD,MAAM,KAAG,QAAQ;CAGlB,CAAC;AAEX,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,eAAO,MAAM,WAAW;uCACE,MAAM,EAAE,KAAG,WAAW;+BAG9B,QAAQ,kCAA2B,WAAW;CAGtD,CAAC"}
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../src/location.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,eAAO,MAAM,QAAQ;oCACE,MAAM,aAAa,MAAM,KAAG,QAAQ;wBAGhD,MAAM,KAAG,QAAQ;CAGlB,CAAC;AAEX,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,WAAW;uCACE,MAAM,EAAE,KAAG,WAAW;+BAG9B,QAAQ,kCAA2B,WAAW;CAGtD,CAAC"}

package/dist/location.js

@@ -6,6 +6,10 @@ export const Location = {
         return { kind: 'stop', id };
     },
 };
+/**
+ * A point the itinerary must pass. How many a request may carry is an environment setting; each pass-through takes
+ * 1 to 10 stop ids and a visit waits 0 to 86400 seconds, else the request fails as `bad_request` on `via`.
+ */
 export const ViaLocation = {
     passThrough(...stopIds) {
         return { kind: 'passThrough', stopIds };

package/dist/location.js.map

@@ -1 +1 @@
-{"version":3,"file":"location.js","sourceRoot":"","sources":["../src/location.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,UAAU,CAAC,QAAgB,EAAE,SAAiB;QAC5C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,EAAU;QACb,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9B,CAAC;CACO,CAAC;AAMX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,CAAC,GAAG,OAAiB;QAC9B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,QAAkB,EAAE,kBAAkB,GAAG,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IACzD,CAAC;CACO,CAAC"}
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../src/location.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,UAAU,CAAC,QAAgB,EAAE,SAAiB;QAC5C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,EAAU;QACb,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9B,CAAC;CACO,CAAC;AAMX;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,CAAC,GAAG,OAAiB;QAC9B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,QAAkB,EAAE,kBAAkB,GAAG,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IACzD,CAAC;CACO,CAAC"}

package/dist/persistedQueries.d.ts

@@ -4,5 +4,6 @@ export interface PersistedOp {
 }
 export declare const DEPARTURES: PersistedOp;
 export declare const PLAN: PersistedOp;
+export declare const PLAN_STREAM: PersistedOp;
 export declare const TRIP: PersistedOp;
 //# sourceMappingURL=persistedQueries.d.ts.map

package/dist/persistedQueries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistedQueries.d.ts","sourceRoot":"","sources":["../src/persistedQueries.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,UAAU,EAAE,WAA4G,CAAC;AACtI,eAAO,MAAM,IAAI,EAAE,WAAsG,CAAC;AAC1H,eAAO,MAAM,IAAI,EAAE,WAAsG,CAAC"}
+{"version":3,"file":"persistedQueries.d.ts","sourceRoot":"","sources":["../src/persistedQueries.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,UAAU,EAAE,WAA4G,CAAC;AACtI,eAAO,MAAM,IAAI,EAAE,WAAsG,CAAC;AAC1H,eAAO,MAAM,WAAW,EAAE,WAA6G,CAAC;AACxI,eAAO,MAAM,IAAI,EAAE,WAAsG,CAAC"}

package/dist/persistedQueries.js

@@ -1,4 +1,5 @@
-export const DEPARTURES = { id: '70a644fe3c6b2cbf5b2d70cef8230c1428bea6357ae1766772162d86469563d0', path: 'departures' };
-export const PLAN = { id: 'dad4f190af803a8cb50ec99c5852544297e94db8edc0d94220c8f79d98f065a7', path: 'plan' };
-export const TRIP = { id: 'e8959a8d47a8e8437ee3ec740cd9c3e28bd401efdd236dde0502559daea53920', path: 'trip' };
+export const DEPARTURES = { id: 'e4ae3f49e06982173b38e945c3c02ef113be05e12564145faeade7758295f536', path: 'departures' };
+export const PLAN = { id: '679549e87f9653ff7a5a021c0b329a2c9658d4701c836139e63712dd9b77981f', path: 'plan' };
+export const PLAN_STREAM = { id: '40380fc4cf10397a4c20d039cc9428b73757c7fce0de2072ae1685a43efbfc15', path: 'plan-stream' };
+export const TRIP = { id: '4a10717f45697a241a0843902808cd696eb8ffd102e93238bf753f865d939a3f', path: 'trip' };
 //# sourceMappingURL=persistedQueries.js.map

package/dist/persistedQueries.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistedQueries.js","sourceRoot":"","sources":["../src/persistedQueries.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,UAAU,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACtI,MAAM,CAAC,MAAM,IAAI,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1H,MAAM,CAAC,MAAM,IAAI,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"persistedQueries.js","sourceRoot":"","sources":["../src/persistedQueries.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,UAAU,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACtI,MAAM,CAAC,MAAM,IAAI,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1H,MAAM,CAAC,MAAM,WAAW,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACxI,MAAM,CAAC,MAAM,IAAI,GAAgB,EAAE,EAAE,EAAE,kEAAkE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC"}

package/dist/polling.d.ts

@@ -6,6 +6,7 @@ export interface PollOptions {
 }
 export declare function pollVehicles(realtime: SpiderRealtime, tripIds: readonly string[], options?: PollOptions): AsyncGenerator<SpiderResult<VehiclePositions>>;
 export declare function pollVehicleForTrip(realtime: SpiderRealtime, tripId: string, options?: PollOptions): AsyncGenerator<SpiderResult<LiveVehicleUpdate>>;
-export declare function pollDelays(realtime: SpiderRealtime, tripIds: readonly string[], options?: PollOptions): AsyncGenerator<SpiderResult<TripDelays>>;
+export declare function pollDelays(realtime: SpiderRealtime, byServiceDate: Readonly<Record<string, readonly string[]>>, options?: PollOptions): AsyncGenerator<SpiderResult<TripDelays>>;
+export declare function pollDelays(realtime: SpiderRealtime, tripIds: readonly string[], serviceDate: string, options?: PollOptions): AsyncGenerator<SpiderResult<TripDelays>>;
 export declare function pollAlerts(realtime: SpiderRealtime, options?: PollOptions): AsyncGenerator<SpiderResult<ServiceAlerts>>;
 //# sourceMappingURL=polling.d.ts.map

package/dist/polling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../src/polling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAEhD;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAEjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAE1C;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAE7C"}
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../src/polling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAEhD;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAEjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,EAC1D,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5C,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;AAa5C,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,cAAc,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAE7C"}

package/dist/polling.js

@@ -4,8 +4,11 @@ export function pollVehicles(realtime, tripIds, options) {
 export function pollVehicleForTrip(realtime, tripId, options) {
     return poll(options, () => realtime.vehicleForTrip(tripId));
 }
-export function pollDelays(realtime, tripIds, options) {
-    return poll(options, () => realtime.delays(tripIds));
+export function pollDelays(realtime, arg, serviceDateOrOptions, options) {
+    if (typeof serviceDateOrOptions === 'string') {
+        return poll(options, () => realtime.delays(arg, serviceDateOrOptions));
+    }
+    return poll(serviceDateOrOptions, () => realtime.delays(arg));
 }
 export function pollAlerts(realtime, options) {
     return poll(options, () => realtime.alerts());

package/dist/polling.js.map

@@ -1 +1 @@
-{"version":3,"file":"polling.js","sourceRoot":"","sources":["../src/polling.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,YAAY,CAC1B,QAAwB,EACxB,OAA0B,EAC1B,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,MAAc,EACd,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,OAA0B,EAC1B,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,IAAI,CAClB,OAAgC,EAChC,KAAqC;IAErC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,OAA2B,CAAC;IAChC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS;YAC1B,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACrC,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC7D,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,GAAG,CAAC;YACd,MAAM,MAAM,CAAC;QACf,CAAC;QACD,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM;QAC3B,MAAM,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../src/polling.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,YAAY,CAC1B,QAAwB,EACxB,OAA0B,EAC1B,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,MAAc,EACd,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAaD,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,GAAoE,EACpE,oBAA2C,EAC3C,OAAqB;IAErB,IAAI,OAAO,oBAAoB,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAwB,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAkD,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAwB,EACxB,OAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,IAAI,CAClB,OAAgC,EAChC,KAAqC;IAErC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,OAA2B,CAAC;IAChC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS;YAC1B,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACrC,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC7D,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,GAAG,CAAC;YACd,MAAM,MAAM,CAAC;QACf,CAAC;QACD,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM;QAC3B,MAAM,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/realtime.d.ts

@@ -5,6 +5,7 @@ export interface FeedFreshness {
     readonly feedTimestampEpochMs: number | null;
     readonly staleSeconds: number | null;
 }
+/** A vehicle's live position. `tripId`, `routeId`, `stopId` and `vehicleId` are feed-prefixed (`<feedId>:<id>`). */
 export interface LiveVehicle {
     readonly tripId: string | null;
     readonly routeId: string | null;
@@ -42,11 +43,22 @@ export interface TripDelay {
     readonly scheduleRelationship: string | null;
     readonly stopTimeUpdates: readonly StopTimeUpdate[];
 }
-export interface TripDelays {
+/** Delays for one GTFS service date: those the feed reported, and the `missing` trip ids it didn't. */
+export interface ServiceDateDelays {
+    readonly serviceDate: string;
     readonly delays: readonly TripDelay[];
     readonly missing: readonly string[];
+}
+/**
+ * Result of {@link SpiderRealtime.delays}: delays grouped by service date (the same `tripId` on two dates is
+ * two distinct instances), plus feed freshness. Look up a single instance with {@link delayFor}.
+ */
+export interface TripDelays {
+    readonly groups: readonly ServiceDateDelays[];
     readonly freshness: FeedFreshness;
 }
+/** The delay for the (`tripId`, `serviceDate`) instance, if the feed reported one; otherwise null. */
+export declare function delayFor(delays: TripDelays, tripId: string, serviceDate: string): TripDelay | null;
 export interface AlertActivePeriod {
     readonly startEpochMs: number | null;
     readonly endEpochMs: number | null;
@@ -75,9 +87,18 @@ export interface ServiceAlerts {
 export declare class SpiderRealtime {
     private readonly transport;
     constructor(transport: Transport);
+    /** Live positions for up to 50 trips. Empty input skips the call; more than 50 fails as `bad_request` without a request. */
     vehicles(tripIds: readonly string[]): Promise<SpiderResult<VehiclePositions>>;
     vehicleForTrip(tripId: string): Promise<SpiderResult<LiveVehicleUpdate>>;
-    delays(tripIds: readonly string[]): Promise<SpiderResult<TripDelays>>;
+    /**
+     * Live delays, resolved per `(tripId, serviceDate)` instance: group trip ids by the GTFS service date
+     * (ISO `YYYY-MM-DD`) they run on — pass each plan leg's or departure's `serviceDate` through. Up to 50 trip ids
+     * in total across all dates. Empty input skips the call; a malformed date or more than 50 ids fails as
+     * `bad_request` without a request.
+     */
+    delays(byServiceDate: Readonly<Record<string, readonly string[]>>): Promise<SpiderResult<TripDelays>>;
+    /** Live delays for `tripIds` all on one `serviceDate` (ISO `YYYY-MM-DD`) — the common single-day case. */
+    delays(tripIds: readonly string[], serviceDate: string): Promise<SpiderResult<TripDelays>>;
     alerts(): Promise<SpiderResult<ServiceAlerts>>;
 }
 //# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

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

package/dist/realtime.js

@@ -1,18 +1,28 @@
 import { parseJson } from "./http.js";
 import { failure, success } from "./result.js";
-import { SpiderContractMismatchError, TransportError, toSpiderError } from "./errors.js";
+import { badRequest, httpFailure, limitRefusal, toSpiderError } from "./errors.js";
+import { invalidServiceDate } from "./serviceDate.js";
 import { occupancyFromWire } from "./enums.js";
+/** The delay for the (`tripId`, `serviceDate`) instance, if the feed reported one; otherwise null. */
+export function delayFor(delays, tripId, serviceDate) {
+    const group = delays.groups.find((g) => g.serviceDate === serviceDate);
+    return group?.delays.find((d) => d.tripId === tripId) ?? null;
+}
 const EMPTY_FRESHNESS = { feedTimestampEpochMs: null, staleSeconds: null };
 const EMPTY_POSITIONS = { vehicles: [], missing: [], freshness: EMPTY_FRESHNESS };
-const EMPTY_DELAYS = { delays: [], missing: [], freshness: EMPTY_FRESHNESS };
+const EMPTY_DELAYS = { groups: [], freshness: EMPTY_FRESHNESS };
+const MAX_TRIP_IDS = 50;
 export class SpiderRealtime {
     transport;
     constructor(transport) {
         this.transport = transport;
     }
+    /** Live positions for up to 50 trips. Empty input skips the call; more than 50 fails as `bad_request` without a request. */
     async vehicles(tripIds) {
         if (tripIds.length === 0)
             return success(EMPTY_POSITIONS);
+        if (tripIds.length > MAX_TRIP_IDS)
+            return failure(badRequest('tripIds'));
         try {
             const dto = await this.transport.getJson('/realtime/vehicles', {
                 tripIds: tripIds.join(','),
@@ -24,8 +34,6 @@ export class SpiderRealtime {
             });
         }
         catch (e) {
-            if (e instanceof SpiderContractMismatchError)
-                throw e;
             return failure(toSpiderError(e));
         }
     }
@@ -33,11 +41,13 @@ export class SpiderRealtime {
         const path = `/realtime/vehicles/by-trip/${encodeURIComponent(tripId)}`;
         try {
             const raw = await this.transport.getRaw(path);
-            if (raw.status === 404) {
-                return success({ vehicle: null, freshness: EMPTY_FRESHNESS });
-            }
             if (!raw.ok) {
-                throw new TransportError('http', `GET ${path} -> ${raw.status}: ${raw.text.slice(0, 300)}`, raw.status);
+                const error = httpFailure(`GET ${path}`, raw.status, raw.text);
+                // A 404 is "no vehicle" unless its body names a plan limit.
+                if (raw.status === 404 && limitRefusal(error) == null) {
+                    return success({ vehicle: null, freshness: EMPTY_FRESHNESS });
+                }
+                throw error;
             }
             const dto = parseJson(raw.text, path);
             return success({
@@ -46,27 +56,33 @@ export class SpiderRealtime {
             });
         }
         catch (e) {
-            if (e instanceof SpiderContractMismatchError)
-                throw e;
             return failure(toSpiderError(e));
         }
     }
-    async delays(tripIds) {
-        if (tripIds.length === 0)
+    async delays(arg, serviceDate) {
+        const byServiceDate = serviceDate !== undefined
+            ? { [serviceDate]: arg }
+            : arg;
+        const queries = Object.entries(byServiceDate).map(([date, tripIds]) => ({ serviceDate: date, tripIds: [...tripIds] }));
+        for (const q of queries) {
+            const invalid = invalidServiceDate(q.serviceDate);
+            if (invalid != null)
+                return failure(invalid);
+        }
+        const total = queries.reduce((n, q) => n + q.tripIds.length, 0);
+        if (total === 0)
             return success(EMPTY_DELAYS);
+        if (total > MAX_TRIP_IDS)
+            return failure(badRequest('tripIds'));
         try {
-            const dto = await this.transport.getJson('/realtime/delays', {
-                tripIds: tripIds.join(','),
-            });
+            const request = { queries };
+            const dto = await this.transport.postJson('/realtime/delays', request);
             return success({
-                delays: (dto.delays ?? []).map(mapDelay),
-                missing: dto.missing ?? [],
+                groups: (dto.results ?? []).map(mapGroupResult),
                 freshness: mapFreshness(dto),
             });
         }
         catch (e) {
-            if (e instanceof SpiderContractMismatchError)
-                throw e;
             return failure(toSpiderError(e));
         }
     }
@@ -79,8 +95,6 @@ export class SpiderRealtime {
             });
         }
         catch (e) {
-            if (e instanceof SpiderContractMismatchError)
-                throw e;
             return failure(toSpiderError(e));
         }
     }
@@ -107,6 +121,13 @@ function mapVehicle(v) {
         timestampEpochMs: secondsToMs(v.timestamp),
     };
 }
+function mapGroupResult(g) {
+    return {
+        serviceDate: g.serviceDate,
+        delays: (g.delays ?? []).map(mapDelay),
+        missing: g.missing ?? [],
+    };
+}
 function mapDelay(d) {
     return {
         tripId: d.tripId ?? null,

package/dist/realtime.js.map

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

package/dist/routing.d.ts

@@ -1,8 +1,8 @@
 import type { Transport } from './http.ts';
 import type { SpiderResult } from './result.ts';
-import type { BikesAllowed, TransitMode, WheelchairBoarding } from './enums.ts';
+import type { SpiderError } from './errors.ts';
+import type { BikesAllowed, InputField, RealtimeState, RoutingErrorCode, TransitMode, WheelchairBoarding } from './enums.ts';
 import type { Location, ViaLocation } from './location.ts';
-import type { RoutingErrorCode, InputField, RealtimeState } from './contract/routing/index.ts';
 export interface LatLon {
     readonly lat: number;
     readonly lon: number;
@@ -11,10 +11,34 @@ export interface Leg {
     readonly mode: TransitMode | null;
     readonly startScheduled: string;
     readonly endScheduled: string;
+    /** Estimated (realtime-adjusted) departure ISO time, when the feed reported one; otherwise null. */
+    readonly startEstimated: string | null;
+    /** Estimated (realtime-adjusted) arrival ISO time, when the feed reported one; otherwise null. */
+    readonly endEstimated: string | null;
+    /** Departure schedule deviation in seconds (positive = late), when known; otherwise null. */
+    readonly startDelaySeconds: number | null;
+    /** Arrival schedule deviation in seconds (positive = late), when known; otherwise null. */
+    readonly endDelaySeconds: number | null;
+    readonly isRealtime: boolean;
+    readonly realtimeState: RealtimeState | null;
+    /** GTFS service date this leg's trip runs on (ISO `YYYY-MM-DD`) — pass to realtime `delays` lookups. */
+    readonly serviceDate: string | null;
     readonly fromName: string | null;
     readonly toName: string | null;
+    /** Stop ids of the leg's endpoints; null for a coordinate endpoint. */
+    readonly fromGtfsId: string | null;
+    readonly toGtfsId: string | null;
+    readonly fromPlatformCode: string | null;
+    readonly toPlatformCode: string | null;
+    readonly fromZoneId: string | null;
+    readonly toZoneId: string | null;
+    readonly routeGtfsId: string | null;
     readonly routeShortName: string | null;
     readonly routeLongName: string | null;
+    /** Route colour as the feed gives it: GTFS hex without `#`, e.g. `FF0000`. */
+    readonly routeColor: string | null;
+    /** Route text colour as the feed gives it: GTFS hex without `#`, e.g. `FFFFFF`. */
+    readonly routeTextColor: string | null;
     readonly headsign: string | null;
     readonly distanceMeters: number | null;
     readonly durationSeconds: number | null;
@@ -48,6 +72,10 @@ export interface RoutePageInfo {
 export interface RoutingError {
     readonly code: RoutingErrorCode;
     readonly description: string;
+    /**
+     * The input the error is about, when there is one. A `LOCATION_NOT_FOUND` names `FROM` (origin), `TO`
+     * (destination) or `VIA` (a via stop id the environment doesn't know).
+     */
     readonly inputField: InputField | null;
 }
 export interface Route {
@@ -56,6 +84,28 @@ export interface Route {
     readonly routingErrors: readonly RoutingError[];
     readonly searchDateTime: string | null;
 }
+/**
+ * One event from {@link SpiderRouting.planStream}. The router sweeps the search window forward and pushes
+ * finalized itineraries as `result`s; a terminal `done` carries the continuation {@link RoutePageInfo}. A
+ * `failure` is terminal and takes the place of the rest.
+ */
+export type PlanStreamEvent = {
+    /** A batch of finalized itineraries as the search frontier advances (with realtime delays on their legs). */
+    readonly type: 'result';
+    readonly itineraries: readonly Itinerary[];
+} | {
+    /** Terminal: the continuation cursors, mirroring {@link Route.pageInfo}. Continue with
+     * {@link SpiderRouting.planStreamNext} (`endCursor`) or {@link SpiderRouting.planStreamPrevious}
+     * (`startCursor`), gated on `hasNextPage` / `hasPreviousPage`. */
+    readonly type: 'done';
+    readonly pageInfo: RoutePageInfo;
+    /** Why the sweep found nothing, mirroring {@link Route.routingErrors}; empty when there is nothing to report. */
+    readonly routingErrors: readonly RoutingError[];
+} | {
+    /** Terminal failure — a transport/HTTP problem, a decoding error, or a server `error` event (`bad_request` for malformed input). */
+    readonly type: 'failure';
+    readonly error: SpiderError;
+};
 export interface Departure {
     readonly scheduledTimeEpochMs: number;
     readonly realtimeTimeEpochMs: number | null;
@@ -63,9 +113,20 @@ export interface Departure {
     readonly realtimeState: RealtimeState | null;
     readonly headsign: string | null;
     readonly tripGtfsId: string | null;
+    /** GTFS service date the trip runs on (ISO `YYYY-MM-DD`) — pass it to {@link SpiderRouting.trip} and realtime `delays`. */
+    readonly serviceDate: string;
+    readonly routeGtfsId: string | null;
     readonly routeShortName: string | null;
     readonly routeLongName: string | null;
+    /** Route colour as the feed gives it: GTFS hex without `#`, e.g. `FF0000`. */
+    readonly routeColor: string | null;
+    /** Route text colour as the feed gives it: GTFS hex without `#`, e.g. `FFFFFF`. */
+    readonly routeTextColor: string | null;
     readonly mode: TransitMode | null;
+    /** The stop this departure leaves from: the board's own stop, or one of a station's platforms. */
+    readonly stopGtfsId: string | null;
+    readonly platformCode: string | null;
+    readonly wheelchairAccessible: WheelchairBoarding | null;
 }
 export interface TripStop {
     readonly gtfsId: string;
@@ -78,15 +139,25 @@ export interface TripStop {
     readonly realtimeDepartureEpochMs: number | null;
     readonly isRealtime: boolean;
     readonly wheelchairBoarding: WheelchairBoarding | null;
+    readonly platformCode: string | null;
+    readonly zoneId: string | null;
 }
 export interface TripDetails {
     readonly gtfsId: string;
+    /** GTFS service date of this trip instance (ISO `YYYY-MM-DD`); null when the trip has no stop times on it. */
+    readonly serviceDate: string | null;
+    readonly routeGtfsId: string | null;
     readonly routeShortName: string | null;
     readonly routeLongName: string | null;
+    /** Route colour as the feed gives it: GTFS hex without `#`, e.g. `FF0000`. */
+    readonly routeColor: string | null;
+    /** Route text colour as the feed gives it: GTFS hex without `#`, e.g. `FFFFFF`. */
+    readonly routeTextColor: string | null;
     readonly mode: TransitMode | null;
     readonly headsign: string | null;
     readonly directionId: string | null;
     readonly bikesAllowed: BikesAllowed | null;
+    readonly wheelchairAccessible: WheelchairBoarding | null;
     readonly stops: readonly TripStop[];
     readonly geometry: readonly LatLon[];
 }
@@ -98,59 +169,89 @@ export interface PlanOptions {
     readonly via?: readonly ViaLocation[];
     /** Restrict routing to these transit modes. Undefined/empty = no filter (all modes); WALK/UNKNOWN drop out. */
     readonly allowedTransitModes?: readonly TransitMode[];
-    /** Absolute cap on transfers in any returned itinerary. Undefined = OTP default. */
+    /** Most transfers in any itinerary (0 = direct only), up to the environment's limit. Undefined = that limit. */
     readonly maxTransfers?: number;
     /**
-     * Search window in minutes (default 60). Always sent, deliberately not OTP's dynamic route-dependent
-     * window — predictable cost + paging. Widen for sparse/intercity routes.
+     * Search window in minutes (default 60), up to the environment's limit. Always sent, deliberately not a
+     * dynamic route-dependent window — predictable cost + paging. Widen for sparse/intercity routes.
      */
     readonly searchWindowMinutes?: number;
     /** Prefer wheelchair-accessible routing. */
     readonly wheelchairAccessible?: boolean;
 }
-/** Options for the streaming `planUntil` — the plan filters plus the walk's bounds. `searchWindowMinutes` is the step. */
-export interface PlanStreamOptions extends PlanOptions {
-    /** Stop once ~this many itineraries have been collected (soft — the window that reaches it is yielded whole). */
-    readonly targetResults?: number;
-    /** Stop after stepping through this much total time (default 360 = 6h). `searchWindowMinutes` is the step size. */
-    readonly maxTraversalMinutes?: number;
-}
-/** Bounds for the streaming continuations `planNextUntil` / `planPreviousUntil` (the step is fixed from `prev`). */
-export interface PlanStreamPageOptions {
-    readonly targetResults?: number;
-    readonly maxTraversalMinutes?: number;
+/**
+ * Options for {@link SpiderRouting.planStream} and its continuations — the server-push SSE stream that opens one
+ * long-lived Server-Sent Events request and pushes itineraries (with realtime delays) as the router sweeps the
+ * window forward. The continuation methods take these same options plus a raw cursor string.
+ */
+export interface PlanStreamRequestOptions {
+    readonly origin: Location;
+    readonly destination: Location;
+    readonly departAt?: number | Date;
+    readonly arriveBy?: number | Date;
+    readonly via?: readonly ViaLocation[];
+    readonly allowedTransitModes?: readonly TransitMode[];
+    readonly maxTransfers?: number;
+    readonly wheelchairAccessible?: boolean;
+    /**
+     * Soft floor: the sweep keeps going until at least this many itineraries are found. From 1 up to the
+     * environment's result count.
+     */
+    readonly targetResults: number;
+    /**
+     * How far the sweep may search, in minutes: at least 120 (2 h), up to the environment's search-window limit.
+     * A smaller value fails as `bad_request` on `maxWindow` before any request.
+     */
+    readonly maxWindowMinutes: number;
 }
 export interface DeparturesOptions {
+    /** Departures from this time on (default now). */
     readonly startTime?: number | Date;
+    /** How far ahead to look, in seconds: above 0, up to 86400 (24 h, the default). */
     readonly timeRangeSeconds?: number;
 }
 export declare class SpiderRouting {
     private readonly transport;
     constructor(transport: Transport);
     plan(options: PlanOptions): Promise<SpiderResult<Route>>;
+    /**
+     * Streams itineraries over Server-Sent Events as the router sweeps the search window forward, emitting them
+     * as they finalize instead of one batched page. Lazy and cancellable: iteration opens the request, and
+     * `break`ing out of the `for await` cancels the underlying stream. Each `result` event carries itineraries
+     * with realtime delays already on their legs; a terminal `done` event then carries the continuation
+     * {@link RoutePageInfo} and any `routingErrors` (or a terminal `failure`). Never throws — transport, HTTP and
+     * request errors surface as a `failure` event.
+     *
+     * `targetResults` (a soft floor the sweep aims to reach) and `maxWindowMinutes` (how far it may search, at
+     * least 2 h) are required. This opens a fresh stream; to continue, call {@link planStreamNext} with
+     * `done.pageInfo.endCursor` (when `hasNextPage`) or {@link planStreamPrevious} with `done.pageInfo.startCursor`
+     * (when `hasPreviousPage`). For a single batched page instead, use {@link plan}.
+     */
+    planStream(options: PlanStreamRequestOptions): AsyncGenerator<PlanStreamEvent>;
+    /**
+     * Continues a stream forward from a prior `done` event's `endCursor`. Takes the same options as
+     * {@link planStream} (so `targetResults` / `maxWindowMinutes` can vary per continuation) plus the raw cursor.
+     * Call only when the prior `done.pageInfo.hasNextPage` was true.
+     */
+    planStreamNext(options: PlanStreamRequestOptions, after: string): AsyncGenerator<PlanStreamEvent>;
+    /**
+     * Continues a stream backward from a prior `done` event's `startCursor`. Takes the same options as
+     * {@link planStream} plus the raw cursor. Call only when the prior `done.pageInfo.hasPreviousPage` was true.
+     */
+    planStreamPrevious(options: PlanStreamRequestOptions, before: string): AsyncGenerator<PlanStreamEvent>;
+    private streamVariables;
+    private openPlanStream;
     planNext(route: Route): Promise<SpiderResult<Route> | null>;
     planPrevious(route: Route): Promise<SpiderResult<Route> | null>;
     /**
-     * Streams itineraries by stepping the search forward one search window at a time, until `targetResults`
-     * itineraries have been collected or `maxTraversalMinutes` of time has been traversed. Each step pulls a
-     * whole window in one search, so a busy window yields more — `targetResults` is a soft floor, the window
-     * that reaches it is yielded whole. Lazy: `for await ... break` stops stepping and skips the remaining OTP
-     * searches. Each yield is one step's `SpiderResult` (a terminal error ends the stream), matching the
-     * non-throwing poll helpers.
-     *
-     * The step is `searchWindowMinutes` and it is fixed for the whole walk — OTP locks the window into the
-     * paging cursor after the first search and ignores it thereafter, so a wider step means a wider
-     * `searchWindowMinutes` here, not on a continuation.
+     * Upcoming departures from a stop or station: `numberOfDepartures` (default 30, up to the environment's
+     * limit) within `options.timeRangeSeconds` (default 24 h) from `options.startTime` (default now).
      */
-    planUntil(options: PlanStreamOptions): AsyncGenerator<SpiderResult<Route>>;
-    /** Streaming form of `planNext`: steps forward from `prev`, one (fixed) search window per step. */
-    planNextUntil(prev: Route, options?: PlanStreamPageOptions): AsyncGenerator<SpiderResult<Route>>;
-    /** Streaming form of `planPrevious`: steps backward from `prev`, one (fixed) search window per step. */
-    planPreviousUntil(prev: Route, options?: PlanStreamPageOptions): AsyncGenerator<SpiderResult<Route>>;
-    private stepFrom;
     departures(stopId: string, numberOfDepartures?: number, options?: DeparturesOptions): Promise<SpiderResult<Departure[]>>;
+    /** One trip on one service date (ISO `YYYY-MM-DD`, e.g. a {@link Departure.serviceDate}); undefined = today. */
     trip(tripId: string, serviceDate?: string): Promise<SpiderResult<TripDetails>>;
     private page;
     private fetchPlan;
 }
+export declare function parsePlanStreamRecord(event: string, data: string): PlanStreamEvent | null;
 //# sourceMappingURL=routing.d.ts.map