go-transit-mcp 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emil Soleymani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# go-planning-mcp
+
+An MCP server that wraps the Metrolinx GO Transit Open Data API, letting LLMs plan trips, check schedules, and query live departures through natural conversation. Self-hostable via Docker or deployable to Vercel in minutes.
+
+## Getting Started
+
+> Work in progress — implementation coming soon.
+
+## Running your own server
+
+Transport split: **Claude Desktop → stdio; everything else → Streamable HTTP.**
+
+### 1. Get a Metrolinx API key
+
+Register at the [Metrolinx Open Data API registration form](https://api.openmetrolinx.com/OpenDataAPI/Help/Registration/en). It's free, but approval is manual and can take up to 10 business days.
+
+### 2. `docker run` one-liner
+
+```bash
+docker run -e METROLINX_API_KEY=xxx -p 3000:3000 ghcr.io/emilsoleymani/go-planning-mcp
+```
+
+This serves the MCP endpoint at `http://localhost:3000/mcp` and a liveness probe at `http://localhost:3000/health`.
+
+### 3. Compose quick start
+
+```bash
+git clone https://github.com/EmilSoleymani/go-planning-mcp.git
+cd go-planning-mcp
+cp .env.example .env  # then add your METROLINX_API_KEY
+docker compose up
+```
+
+### 4. Claude Desktop (stdio)
+
+```json
+{
+  "mcpServers": {
+    "go-transit": {
+      "command": "npx",
+      "args": ["go-transit-mcp"],
+      "env": {
+        "METROLINX_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+```
+
+From source (contributor/dev variant):
+
+```json
+{
+  "mcpServers": {
+    "go-transit": {
+      "command": "node",
+      "args": ["dist/entry/stdio.js"],
+      "env": {
+        "METROLINX_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/entry/http.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import { createServer, } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { cacheEnabledFromEnv } from "../metrolinx/cache.js";
+import { MetrolinxHttpClient } from "../metrolinx/client.js";
+import { buildServer } from "../server.js";
+const apiKey = process.env.METROLINX_API_KEY;
+if (!apiKey) {
+    console.error("METROLINX_API_KEY is required. Set it in the environment (see .env.example).");
+    process.exit(1);
+}
+const port = Number(process.env.PORT ?? 3000);
+const client = new MetrolinxHttpClient({
+    apiKey,
+    cacheEnabled: cacheEnabledFromEnv(process.env.CACHE_ENABLED),
+});
+function methodNotAllowed(res) {
+    res.writeHead(405, { "content-type": "application/json" }).end(JSON.stringify({
+        jsonrpc: "2.0",
+        error: { code: -32000, message: "Method not allowed." },
+        id: null,
+    }));
+}
+// Pure liveness: no upstream Metrolinx call (docker-deployment spec §2).
+function health(res) {
+    res
+        .writeHead(200, { "content-type": "application/json" })
+        .end(JSON.stringify({ status: "ok" }));
+}
+// One MCP server + transport per request, stateless mode
+// (sessionIdGenerator: undefined) — the same pattern the SDK's stateless
+// example and Vercel's mcp-handler use, so all three entry surfaces share
+// buildServer() without diverging on session lifecycle.
+async function handleMcp(req, res) {
+    if (req.method === "GET" || req.method === "DELETE") {
+        methodNotAllowed(res);
+        return;
+    }
+    const mcpServer = buildServer(client);
+    // Omitting sessionIdGenerator (rather than setting it to undefined) means
+    // stateless mode without tripping exactOptionalPropertyTypes.
+    const transport = new StreamableHTTPServerTransport({});
+    res.on("close", () => {
+        void transport.close();
+        void mcpServer.close();
+    });
+    // The SDK's own Transport getters/setters are typed `T | undefined`,
+    // wider than the Transport interface's `T | undefined`-less optional
+    // fields; exactOptionalPropertyTypes rejects the structural match even
+    // though the class declares `implements Transport`.
+    await mcpServer.connect(transport);
+    await transport.handleRequest(req, res);
+}
+const httpServer = createServer((req, res) => {
+    const url = new URL(req.url ?? "/", "http://localhost");
+    if (url.pathname === "/health") {
+        health(res);
+        return;
+    }
+    if (url.pathname === "/mcp") {
+        handleMcp(req, res).catch((error) => {
+            console.error("Error handling MCP request:", error);
+            if (!res.headersSent) {
+                res.writeHead(500, { "content-type": "application/json" }).end(JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: { code: -32603, message: "Internal server error" },
+                    id: null,
+                }));
+            }
+        });
+        return;
+    }
+    res.writeHead(404).end();
+});
+httpServer.listen(port, () => {
+    console.error(`go-transit-mcp listening on port ${String(port)}`);
+});
+//# sourceMappingURL=http.js.map

package/dist/entry/http.js.map

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

package/dist/entry/stdio.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { cacheEnabledFromEnv } from "../metrolinx/cache.js";
+import { MetrolinxHttpClient } from "../metrolinx/client.js";
+import { buildServer } from "../server.js";
+const apiKey = process.env.METROLINX_API_KEY;
+if (!apiKey) {
+    console.error("METROLINX_API_KEY is required. Set it in the environment (see .env.example).");
+    process.exit(1);
+}
+const server = buildServer(new MetrolinxHttpClient({
+    apiKey,
+    cacheEnabled: cacheEnabledFromEnv(process.env.CACHE_ENABLED),
+}));
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=stdio.js.map

package/dist/entry/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/entry/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CACX,8EAA8E,CAC/E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,WAAW,CACxB,IAAI,mBAAmB,CAAC;IACtB,MAAM;IACN,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;CAC7D,CAAC,CACH,CAAC;AACF,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/**
+ * An operational failure surfaced to the LLM as an in-result error
+ * (tool-schemas spec §1.5). Messages are instructions for the model,
+ * not diagnostics.
+ */
+export class MetrolinxError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable) {
+        super(message);
+        this.name = "MetrolinxError";
+        this.code = code;
+        this.retryable = retryable;
+    }
+}
+export function toToolErrorResult(error) {
+    const payload = {
+        error: {
+            code: error.code,
+            message: error.message,
+            retryable: error.retryable,
+        },
+    };
+    return {
+        isError: true,
+        content: [{ type: "text", text: JSON.stringify(payload) }],
+        structuredContent: payload,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IACzB,SAAS,CAAU;IAE5B,YAAY,IAAwB,EAAE,OAAe,EAAE,SAAkB;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,OAAO,GAAG;QACd,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B;KACF,CAAC;IACF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC"}

package/dist/metrolinx/cache.js

@@ -0,0 +1,29 @@
+// In-process, best-effort TTL cache (caching spec, ticket 005). No
+// dependencies, no invalidation beyond time — full benefit on the
+// long-lived Docker process, degrades to a no-op across cold Vercel
+// invocations.
+export class TtlCache {
+    enabled;
+    store = new Map();
+    constructor(options = {}) {
+        this.enabled = options.enabled ?? true;
+    }
+    async getOrFetch(key, ttlMs, fetcher) {
+        if (!this.enabled)
+            return fetcher();
+        const hit = this.store.get(key);
+        const now = Date.now();
+        if (hit && hit.expiresAt > now)
+            return hit.value;
+        const value = await fetcher();
+        this.store.set(key, { value, expiresAt: now + ttlMs });
+        return value;
+    }
+}
+/** CACHE_ENABLED env var: disabled only on an explicit "false"/"0"; default on. */
+export function cacheEnabledFromEnv(value) {
+    if (value === undefined)
+        return true;
+    return !["false", "0"].includes(value.trim().toLowerCase());
+}
+//# sourceMappingURL=cache.js.map

package/dist/metrolinx/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/metrolinx/cache.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kEAAkE;AAClE,oEAAoE;AACpE,eAAe;AAWf,MAAM,OAAO,QAAQ;IACF,OAAO,CAAU;IACjB,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,YAAY,UAAwB,EAAE;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAW,EACX,KAAa,EACb,OAAyB;QAEzB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,EAAE,CAAC;QAEpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,GAAG,GAAG;YAAE,OAAO,GAAG,CAAC,KAAU,CAAC;QAEtD,MAAM,KAAK,GAAG,MAAM,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/metrolinx/client.js

@@ -0,0 +1,180 @@
+import { MetrolinxError } from "../errors.js";
+import { TtlCache } from "./cache.js";
+const DEFAULT_BASE_URL = "https://api.openmetrolinx.com/OpenDataAPI/api/V1";
+const MAX_RETRIES = 2;
+const BACKOFF_BASE_MS = 500;
+const BACKOFF_CAP_MS = 5000;
+// Caching spec (ticket 005): stops are slow-changing (24h); fares and
+// published schedules are effectively static once a service day is
+// published (6h); next-service, destinations, and fleet consist (live
+// physical makeup, research handoff §2.7) are real-time and never cached.
+const STOP_ALL_TTL_MS = 24 * 60 * 60 * 1000;
+const FARES_TTL_MS = 6 * 60 * 60 * 1000;
+const SCHEDULE_TTL_MS = 6 * 60 * 60 * 1000;
+const SERVICE_GLANCE_SEGMENT = {
+    train: "Trains",
+    bus: "Buses",
+    upx: "UPX",
+};
+export class MetrolinxHttpClient {
+    apiKey;
+    baseUrl;
+    sleep;
+    cache;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.sleep =
+            options.sleep ??
+                ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.cache = new TtlCache({ enabled: options.cacheEnabled ?? true });
+    }
+    async getStopDetails(stopCode) {
+        return this.get(`/Stop/Details/${encodeURIComponent(stopCode)}`);
+    }
+    async getStopAll() {
+        return this.cache.getOrFetch("stop-all", STOP_ALL_TTL_MS, () => this.get("/Stop/All"));
+    }
+    async getNextService(stopCode) {
+        return this.get(`/Stop/NextService/${encodeURIComponent(stopCode)}`);
+    }
+    async getStopDestinations(stopCode, fromTimeWire, toTimeWire) {
+        return this.get(`/Stop/Destinations/${encodeURIComponent(stopCode)}/${fromTimeWire}/${toTimeWire}`);
+    }
+    async getFares(fromStopCode, toStopCode, dateWire) {
+        const from = encodeURIComponent(fromStopCode);
+        const to = encodeURIComponent(toStopCode);
+        const path = dateWire
+            ? `/Fares/${from}/${to}/${dateWire}`
+            : `/Fares/${from}/${to}`;
+        return this.cache.getOrFetch(`fares:${fromStopCode}:${toStopCode}:${dateWire ?? ""}`, FARES_TTL_MS, () => this.get(path));
+    }
+    async getFleetConsistAll() {
+        return this.get("/Fleet/Consist/All");
+    }
+    async getFleetConsistByEngine(engineNumber) {
+        return this.get(`/Fleet/Consist/Engine/${encodeURIComponent(engineNumber)}`);
+    }
+    // Alerts change through the day and have no caching tier assigned by the
+    // caching spec (ticket 005 only names stops/schedules/fares) — left
+    // uncached rather than guessing a TTL.
+    async getServiceAlerts() {
+        return this.get("/ServiceUpdate/ServiceAlert/All");
+    }
+    async getInformationAlerts() {
+        return this.get("/ServiceUpdate/InformationAlert/All");
+    }
+    async getMarketingAlerts() {
+        return this.get("/ServiceUpdate/MarketingAlert/All");
+    }
+    async getUnionDepartures() {
+        return this.get("/ServiceUpdate/UnionDepartures/All");
+    }
+    async getServiceExceptions(mode) {
+        const segment = mode === "train" ? "Train" : mode === "bus" ? "Bus" : "All";
+        return this.get(`/ServiceUpdate/Exceptions/${segment}`);
+    }
+    async getServiceGuarantee(tripNumber, dateWire) {
+        return this.get(`/ServiceUpdate/ServiceGuarantee/${encodeURIComponent(tripNumber)}/${dateWire}`);
+    }
+    async getLineAll(dateWire) {
+        return this.cache.getOrFetch(`line-all:${dateWire}`, SCHEDULE_TTL_MS, () => this.get(`/Schedule/Line/All/${dateWire}`));
+    }
+    async getLineSchedule(dateWire, lineCode, direction) {
+        return this.cache.getOrFetch(`line-schedule:${dateWire}:${lineCode}:${direction}`, SCHEDULE_TTL_MS, () => this.get(`/Schedule/Line/${dateWire}/${encodeURIComponent(lineCode)}/${encodeURIComponent(direction)}`));
+    }
+    async getTripStatus(dateWire, tripNumber) {
+        return this.get(`/Schedule/Trip/${dateWire}/${encodeURIComponent(tripNumber)}`);
+    }
+    // Real-time, never cached (caching spec, ticket 005).
+    async getServiceGlance(mode) {
+        return this.get(`/ServiceataGlance/${SERVICE_GLANCE_SEGMENT[mode]}/All`);
+    }
+    // Plain feed, same section as getTripUpdates below. NOT
+    // Fleet/Occupancy/GtfsRT/Feed/VehiclePosition: that Fleet-branded twin is
+    // documented (research handoff §2.7) as where occupancy_percentage is
+    // actually populated, but it empirically returns a genuine HTTP 401 for a
+    // standard registered key (confirmed live, issue #11/PR #26) — see
+    // docs/spec/tool-schemas.md §5. occupancy_percent is consequently
+    // expected to be absent in practice; kept optional in the DTO rather than
+    // dropped, so it starts populating automatically if that ever changes.
+    async getVehiclePositions() {
+        return this.get("/Gtfs/Feed/VehiclePosition");
+    }
+    async getTripUpdates() {
+        return this.get("/Gtfs/Feed/TripUpdates");
+    }
+    // Journey plans are real-time (caching spec, ticket 005) — never cached.
+    async getJourney(dateWire, fromStopCode, toStopCode, startTimeWire, maxJourneys) {
+        return this.get(`/Schedule/Journey/${dateWire}/${encodeURIComponent(fromStopCode)}/${encodeURIComponent(toStopCode)}/${startTimeWire}/${String(maxJourneys)}`);
+    }
+    // ADR 0001: at most 2 retries, only on retryable failures — network errors
+    // and 5xx, including 5xx tunneled through HTTP 200 bodies. 429 is never
+    // retried; it surfaces to the LLM immediately.
+    async get(path) {
+        for (let attempt = 0;; attempt += 1) {
+            try {
+                return await this.requestOnce(path);
+            }
+            catch (error) {
+                if (error instanceof MetrolinxError &&
+                    error.retryable &&
+                    attempt < MAX_RETRIES) {
+                    await this.sleep(fullJitterDelay(attempt));
+                    continue;
+                }
+                throw error;
+            }
+        }
+    }
+    async requestOnce(path) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        url.searchParams.set("key", this.apiKey);
+        let response;
+        try {
+            response = await fetch(url, { headers: { Accept: "application/json" } });
+        }
+        catch {
+            throw new MetrolinxError("upstream_unavailable", "Metrolinx API unreachable; try again later.", true);
+        }
+        if (response.status === 429)
+            throw rateLimitedError();
+        if (response.status >= 500) {
+            throw new MetrolinxError("upstream_unavailable", "Metrolinx API unreachable; try again later.", true);
+        }
+        if (!response.ok) {
+            throw new MetrolinxError("upstream_error", `Metrolinx API returned HTTP ${String(response.status)}.`, false);
+        }
+        const body = (await response.json());
+        // Metrolinx tunnels failures through HTTP 200 bodies — the status line
+        // lies; only Metadata.ErrorCode tells the truth (ticket 001). "204" is
+        // not a failure despite the tunneling mechanism: confirmed live
+        // (issue #7) for an unknown stop code across Stop/Details,
+        // Stop/NextService, and Stop/Destinations — ErrorMessage "No Content",
+        // data field null. Treated as a passthrough so each tool's own
+        // null-check produces `not_found` instead of a generic upstream error.
+        const tunneled = body.Metadata?.ErrorCode;
+        if (tunneled && tunneled !== "200" && tunneled !== "204") {
+            throw tunneledError(tunneled, body.Metadata?.ErrorMessage ?? undefined);
+        }
+        return body;
+    }
+}
+function rateLimitedError() {
+    return new MetrolinxError("rate_limited", "Metrolinx rate limit hit. Do not retry now; tell the user real-time data is temporarily unavailable.", false);
+}
+function tunneledError(code, message) {
+    if (code === "429")
+        return rateLimitedError();
+    if (code === "401") {
+        return new MetrolinxError("upstream_auth_failed", "Server misconfigured; operator must check METROLINX_API_KEY. Do not retry.", false);
+    }
+    if (code.startsWith("5")) {
+        return new MetrolinxError("upstream_unavailable", "Metrolinx API unreachable; try again later.", true);
+    }
+    return new MetrolinxError("upstream_error", message ?? `Metrolinx reported error ${code}.`, false);
+}
+function fullJitterDelay(attempt) {
+    return (Math.random() * Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * 2 ** attempt));
+}
+//# sourceMappingURL=client.js.map

package/dist/metrolinx/client.js.map

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

package/dist/metrolinx/types.js

@@ -0,0 +1,5 @@
+// Raw Metrolinx response shapes, PascalCase exactly as delivered upstream.
+// Confirmed against live captures by scripts/capture-fixtures.ts (issue #3) —
+// see test/fixtures/ for the underlying samples.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/metrolinx/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metrolinx/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,iDAAiD"}

package/dist/normalize/fares.js

@@ -0,0 +1,44 @@
+import { MetrolinxError } from "../errors.js";
+const RIDER_BY_CATEGORY = {
+    Adult: "adult",
+    Student: "student",
+    Senior: "senior",
+    Child: "child",
+    // "Group Pass" (live-confirmed, issue #3) is a bulk purchase, not a rider
+    // category — it has no slot in the closed rider enum and is dropped below.
+};
+function normalizeMethod(type) {
+    // Only "Paper"/"Presto" observed live (issue #3); best-effort default to
+    // "paper" for anything else, same spirit as normalizeMode's ServiceType
+    // fallback in normalize/next-service.ts.
+    return type.toLowerCase() === "presto" ? "presto" : "paper";
+}
+export function normalizeFares(raw) {
+    const categories = raw.AllFares?.FareCategory;
+    if (!categories) {
+        throw new MetrolinxError("not_found", "No fare found between those stops. Verify both codes via search_stops.", false);
+    }
+    const fares = [];
+    for (const category of categories) {
+        const rider = RIDER_BY_CATEGORY[category.Type];
+        if (!rider)
+            continue;
+        for (const ticket of category.Tickets ?? []) {
+            const method = normalizeMethod(ticket.Type);
+            for (const fare of ticket.Fares ?? []) {
+                fares.push({
+                    rider,
+                    method,
+                    amount: fare.Amount,
+                    category: fare.Category,
+                });
+            }
+        }
+    }
+    return {
+        fares,
+        truncated: false,
+        total_matched: fares.length,
+    };
+}
+//# sourceMappingURL=fares.js.map

package/dist/normalize/fares.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fares.js","sourceRoot":"","sources":["../../src/normalize/fares.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,iBAAiB,GAAkC;IACvD,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,0EAA0E;IAC1E,2EAA2E;CAC5E,CAAC;AAEF,SAAS,eAAe,CAAC,IAAY;IACnC,yEAAyE;IACzE,wEAAwE;IACxE,yCAAyC;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAqB;IAClD,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,cAAc,CACtB,WAAW,EACX,wEAAwE,EACxE,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC;oBACT,KAAK;oBACL,MAAM;oBACN,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,KAAK,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}

package/dist/normalize/fleet-consist.js

@@ -0,0 +1,31 @@
+/** The consist currently assigned to a trip, found by scanning each consist's remaining-trip list. */
+export function findConsistByTrip(raw, tripNumber) {
+    const consists = raw.AllConsists?.Consists ?? [];
+    return consists.find((consist) => (consist.RemainingTrip ?? []).some((trip) => trip.Number === tripNumber));
+}
+/** Fleet/Consist/Engine/{EngineNumber} returns the AllConsists shape filtered to one engine. */
+export function firstConsist(raw) {
+    return raw.AllConsists?.Consists?.[0];
+}
+export function normalizeFleetConsist(consist) {
+    return {
+        engine_number: consist.EngineNumber,
+        coach_count: consist.CoachCount,
+        cars: (consist.Lineup ?? []).map((car) => ({
+            type: car.Type,
+            order: car.Order,
+            number: car.Number,
+        })),
+        // start_time/end_time formats aren't live-confirmed (no Fleet access this
+        // session, see metrolinx/types.ts) — passed through as opaque strings
+        // rather than guessed at, same treatment as get_trip_status's status
+        // fields (issue #8/#22).
+        remaining_trips: (consist.RemainingTrip ?? []).map((trip) => ({
+            trip_number: trip.Number,
+            line: trip.Corridor,
+            start_time: trip.StartTime,
+            end_time: trip.EndTime,
+        })),
+    };
+}
+//# sourceMappingURL=fleet-consist.js.map

package/dist/normalize/fleet-consist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-consist.js","sourceRoot":"","sources":["../../src/normalize/fleet-consist.ts"],"names":[],"mappings":"AAMA,sGAAsG;AACtG,MAAM,UAAU,iBAAiB,CAC/B,GAA4B,EAC5B,UAAkB;IAElB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC/B,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAC1B,GAA4B;IAE5B,OAAO,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAmB;IACvD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,0EAA0E;QAC1E,sEAAsE;QACtE,qEAAqE;QACrE,yBAAyB;QACzB,eAAe,EAAE,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5D,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,QAAQ,EAAE,IAAI,CAAC,OAAO;SACvB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}