lt-public-transport-sdk 1.1.0 → 1.2.1

package/README.md

@@ -1,13 +1,11 @@
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-donate-yellow.svg)](https://www.buymeacoffee.com/gmacev)
+
 # lt-public-transport-sdk
 
 A robust, type-safe TypeScript SDK for accessing **real-time public transport data** in Lithuanian cities.
 
 It handles the complexity of parsing raw GPS streams (HTML/CSV), normalizing coordinate formats, handling text encodings (Windows-1257), and merging live data with static GTFS schedules (routes, stops).
 
-![License](https://img.shields.io/badge/license-MIT-blue.svg)
-![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)
-![Tests](https://img.shields.io/badge/Coverage-100%25-brightgreen.svg)
-
 ## 🚀 Why use this SDK?
 
 Raw public transport data in Lithuania (from stops.lt) is fragmented and messy:
@@ -170,14 +168,20 @@ const cities = client.getCities(); // includes 'marijampole'
 
 #### Methods
 
-| Method                    | Returns               | Description                                                                                              |
-| ------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------- |
-| **`getVehicles(city)`**   | `Promise<Vehicle[]>`  | Fetches real-time vehicle positions. If `autoEnrich` is true, ensures GTFS data is synced and merges it. |
-| **`sync(city, force?)`**  | `Promise<SyncResult>` | Manually downloads/updates GTFS static data (routes/stops). Throttled to 60s unless `force=true`.        |
-| **`getRoutes(city)`**     | `Promise<Route[]>`    | Returns the list of static routes from GTFS. Requires prior `sync()`.                                    |
-| **`getStops(city)`**      | `Promise<Stop[]>`     | Returns the list of static stops from GTFS. Requires prior `sync()`.                                     |
-| **`getCities()`**         | `CityId[]`            | Returns a list of all supported city identifiers.                                                        |
-| **`getCityConfig(city)`** | `CityConfig`          | Returns configuration details (tier, URLs) for a specific city.                                          |
+| Method                       | Returns                              | Description                                                                                              |
+| ---------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------- |
+| **`getVehicles(city)`**      | `Promise<Vehicle[]>`                 | Fetches real-time vehicle positions. If `autoEnrich` is true, ensures GTFS data is synced and merges it. |
+| **`sync(city, force?)`**     | `Promise<SyncResult>`                | Manually downloads/updates GTFS static data (routes/stops). Throttled to 60s unless `force=true`.        |
+| **`getRoutes(city)`**        | `Promise<Route[]>`                   | Returns the list of static routes from GTFS. Requires prior `sync()`.                                    |
+| **`getStops(city)`**         | `Promise<Stop[]>`                    | Returns the list of static stops from GTFS. Requires prior `sync()`.                                     |
+| **`getTrips(city)`**         | `Promise<Trip[]>`                    | Returns all trips with route/service/shape linkage. Requires prior `sync()`.                             |
+| **`getShapes(city)`**        | `Promise<Map<string, ShapePoint[]>>` | Returns route polylines grouped by shape ID. Requires prior `sync()`.                                    |
+| **`getCalendar(city)`**      | `Promise<Calendar[]>`                | Returns service calendars (which days services operate). Requires prior `sync()`.                        |
+| **`getCalendarDates(city)`** | `Promise<CalendarDate[]>`            | Returns calendar exceptions (holidays, special dates). Requires prior `sync()`.                          |
+| **`getAgencies(city)`**      | `Promise<Agency[]>`                  | Returns transit agency information. Requires prior `sync()`.                                             |
+| **`getSchedule(city)`**      | `Promise<Map<string, StopTime[]>>`   | Returns stop times grouped by trip ID (⚠️ large dataset). Requires prior `sync()`.                       |
+| **`getCities()`**            | `CityId[]`                           | Returns a list of all supported city identifiers.                                                        |
+| **`getCityConfig(city)`**    | `CityConfig`                         | Returns configuration details (tier, URLs) for a specific city.                                          |
 
 ### Key Types
 
@@ -277,6 +281,159 @@ interface Stop {
 }
 ```
 
+#### `Trip` (GTFS)
+
+```typescript
+interface Trip {
+  /** Unique trip ID */
+  readonly id: string;
+
+  /** Route ID reference */
+  readonly routeId: string;
+
+  /** Service/calendar ID */
+  readonly serviceId: string;
+
+  /** Trip destination headsign */
+  readonly headsign: string;
+
+  /** Trip short name (optional) */
+  readonly shortName: string | null;
+
+  /** Direction (0 or 1) */
+  readonly directionId: number | null;
+
+  /** Shape ID reference (for drawing route path) */
+  readonly shapeId: string | null;
+}
+```
+
+#### `ShapePoint` (GTFS)
+
+```typescript
+interface ShapePoint {
+  /** Shape ID */
+  readonly shapeId: string;
+
+  /** Latitude */
+  readonly latitude: number;
+
+  /** Longitude */
+  readonly longitude: number;
+
+  /** Point sequence in shape */
+  readonly sequence: number;
+
+  /** Distance traveled along shape (optional) */
+  readonly distanceTraveled: number | null;
+}
+```
+
+#### `Calendar` (GTFS)
+
+```typescript
+interface Calendar {
+  /** Service ID */
+  readonly serviceId: string;
+
+  /** Operates on Mondays */
+  readonly monday: boolean;
+
+  /** Operates on Tuesdays */
+  readonly tuesday: boolean;
+
+  /** Operates on Wednesdays */
+  readonly wednesday: boolean;
+
+  /** Operates on Thursdays */
+  readonly thursday: boolean;
+
+  /** Operates on Fridays */
+  readonly friday: boolean;
+
+  /** Operates on Saturdays */
+  readonly saturday: boolean;
+
+  /** Operates on Sundays */
+  readonly sunday: boolean;
+
+  /** Service start date (ISO format YYYY-MM-DD) */
+  readonly startDate: string;
+
+  /** Service end date (ISO format YYYY-MM-DD) */
+  readonly endDate: string;
+}
+```
+
+#### `CalendarDate` (GTFS)
+
+```typescript
+interface CalendarDate {
+  /** Service ID */
+  readonly serviceId: string;
+
+  /** Exception date (ISO format YYYY-MM-DD) */
+  readonly date: string;
+
+  /** Exception type */
+  readonly exceptionType: "added" | "removed";
+}
+```
+
+#### `Agency` (GTFS)
+
+```typescript
+interface Agency {
+  /** Agency ID (optional if only one agency) */
+  readonly id: string | null;
+
+  /** Agency name */
+  readonly name: string;
+
+  /** Agency website URL */
+  readonly url: string;
+
+  /** Agency timezone */
+  readonly timezone: string;
+
+  /** Agency language code */
+  readonly language: string | null;
+
+  /** Agency phone number */
+  readonly phone: string | null;
+}
+```
+
+#### `StopTime` (GTFS)
+
+```typescript
+interface StopTime {
+  /** Trip ID */
+  readonly tripId: string;
+
+  /** Stop ID */
+  readonly stopId: string;
+
+  /** Arrival time (HH:MM:SS format, may exceed 24:00:00) */
+  readonly arrivalTime: string;
+
+  /** Departure time (HH:MM:SS format, may exceed 24:00:00) */
+  readonly departureTime: string;
+
+  /** Stop sequence (0-based) */
+  readonly sequence: number;
+
+  /** Stop headsign override */
+  readonly stopHeadsign: string | null;
+
+  /** Pickup type (0=regular, 1=none, etc.) */
+  readonly pickupType: number | null;
+
+  /** Drop-off type (0=regular, 1=none, etc.) */
+  readonly dropOffType: number | null;
+}
+```
+
 ## 💾 Caching & Best Practices
 
 By default, GTFS data (routes & stops) is cached in your system's temporary directory (`os.tmpdir()/lt-transport-sdk-cache`).
@@ -338,3 +495,9 @@ npm run test:integration
 ## 📄 License
 
 MIT
+
+## Support
+
+If you found this SDK useful for your project, consider buying me a coffee! It helps me keep the reverse-engineering efforts going.
+
+<a href="https://www.buymeacoffee.com/gmacev" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>

package/dist/gtfs/index.d.ts

@@ -2,6 +2,6 @@
  * GTFS module exports
  * @module gtfs
  */
-export { parseRoutesContent, parseStopsContent, } from './parser.js';
-export { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops, type SyncOptions, type GtfsCache, } from './sync.js';
+export { parseRoutesContent, parseStopsContent, parseTripsContent, parseShapesContent, parseCalendarContent, parseCalendarDatesContent, parseAgencyContent, parseStopTimesContent, } from './parser.js';
+export { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops, loadCachedTrips, loadCachedShapes, loadCachedCalendar, loadCachedCalendarDates, loadCachedAgencies, loadCachedStopTimes, type SyncOptions, type GtfsCache, } from './sync.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/gtfs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gtfs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gtfs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,WAAW,CAAC"}

package/dist/gtfs/index.js

@@ -2,6 +2,6 @@
  * GTFS module exports
  * @module gtfs
  */
-export { parseRoutesContent, parseStopsContent, } from './parser.js';
-export { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops, } from './sync.js';
+export { parseRoutesContent, parseStopsContent, parseTripsContent, parseShapesContent, parseCalendarContent, parseCalendarDatesContent, parseAgencyContent, parseStopTimesContent, } from './parser.js';
+export { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops, loadCachedTrips, loadCachedShapes, loadCachedCalendar, loadCachedCalendarDates, loadCachedAgencies, loadCachedStopTimes, } from './sync.js';
 //# sourceMappingURL=index.js.map

package/dist/gtfs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gtfs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,eAAe,GAGhB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gtfs/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,WAAW,CAAC"}

package/dist/gtfs/parser.d.ts

@@ -1,8 +1,9 @@
 /**
- * GTFS file parsers for routes.txt and stops.txt
+ * GTFS file parsers for routes.txt, stops.txt, trips.txt, shapes.txt,
+ * calendar.txt, calendar_dates.txt, agency.txt, and stop_times.txt
  * @module gtfs/parser
  */
-import type { Route, Stop } from '../types.js';
+import type { Route, Stop, Trip, ShapePoint, Calendar, CalendarDate, Agency, StopTime } from '../types.js';
 /**
  * Parse routes.txt content into a Map keyed by route short name.
  *
@@ -36,4 +37,50 @@ export declare function parseRoutesContent(content: string): Map<string, Route>;
  * @returns Array of Stop objects
  */
 export declare function parseStopsContent(content: string): Stop[];
+/**
+ * Parse trips.txt content into a Map keyed by trip_id.
+ *
+ * @param content - Raw trips.txt content
+ * @returns Map from trip_id to Trip object
+ */
+export declare function parseTripsContent(content: string): Map<string, Trip>;
+/**
+ * Parse shapes.txt content into a Map grouped by shape_id.
+ * Points within each shape are sorted by sequence.
+ *
+ * @param content - Raw shapes.txt content
+ * @returns Map from shape_id to array of ShapePoint objects
+ */
+export declare function parseShapesContent(content: string): Map<string, ShapePoint[]>;
+/**
+ * Parse calendar.txt content into a Map keyed by service_id.
+ *
+ * @param content - Raw calendar.txt content
+ * @returns Map from service_id to Calendar object
+ */
+export declare function parseCalendarContent(content: string): Map<string, Calendar>;
+/**
+ * Parse calendar_dates.txt content into an array of CalendarDate objects.
+ *
+ * @param content - Raw calendar_dates.txt content
+ * @returns Array of CalendarDate objects
+ */
+export declare function parseCalendarDatesContent(content: string): CalendarDate[];
+/**
+ * Parse agency.txt content into an array of Agency objects.
+ *
+ * @param content - Raw agency.txt content
+ * @returns Array of Agency objects
+ */
+export declare function parseAgencyContent(content: string): Agency[];
+/**
+ * Parse stop_times.txt content into a Map grouped by trip_id.
+ * Stop times within each trip are sorted by sequence.
+ *
+ * Note: This file can be large (~25MB for Vilnius). Use appropriate memory management.
+ *
+ * @param content - Raw stop_times.txt content
+ * @returns Map from trip_id to array of StopTime objects
+ */
+export declare function parseStopTimesContent(content: string): Map<string, StopTime[]>;
 //# sourceMappingURL=parser.d.ts.map

package/dist/gtfs/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/gtfs/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAe,MAAM,aAAa,CAAC;AAoE5D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAsDtE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,CAiDzD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/gtfs/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AA6ExH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAsDtE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,CAiDzD;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAgDpE;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAwD7E;AAcD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAmD3E;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CA0CzE;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA6C5D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAyD9E"}

package/dist/gtfs/parser.js

@@ -1,10 +1,11 @@
 /**
- * GTFS file parsers for routes.txt and stops.txt
+ * GTFS file parsers for routes.txt, stops.txt, trips.txt, shapes.txt,
+ * calendar.txt, calendar_dates.txt, agency.txt, and stop_times.txt
  * @module gtfs/parser
  */
 import { GTFS_ROUTE_TYPE_MAP } from '../types.js';
 import { cleanTextField } from '../utils/index.js';
-import { gtfsRouteSchema, gtfsStopSchema } from '../schemas.js';
+import { gtfsRouteSchema, gtfsStopSchema, gtfsTripSchema, gtfsShapeSchema, gtfsCalendarSchema, gtfsCalendarDateSchema, gtfsAgencySchema, gtfsStopTimeSchema, } from '../schemas.js';
 // =============================================================================
 // CSV Parsing Utilities
 // =============================================================================
@@ -186,4 +187,329 @@ export function parseStopsContent(content) {
     }
     return stops;
 }
+// =============================================================================
+// Trips Parser
+// =============================================================================
+/**
+ * Parse trips.txt content into a Map keyed by trip_id.
+ *
+ * @param content - Raw trips.txt content
+ * @returns Map from trip_id to Trip object
+ */
+export function parseTripsContent(content) {
+    const lines = content.split('\n').filter(line => line.trim());
+    if (lines.length < 2) {
+        return new Map();
+    }
+    const firstLine = lines[0];
+    if (firstLine === undefined || firstLine === '') {
+        return new Map();
+    }
+    const headers = parseCSVLine(firstLine);
+    const headerMap = buildHeaderMap(headers);
+    const trips = new Map();
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line === '')
+            continue;
+        const row = parseCSVLine(line);
+        try {
+            const rowObject = buildRowObject(row, headerMap);
+            const parseResult = gtfsTripSchema.safeParse(rowObject);
+            if (!parseResult.success) {
+                continue;
+            }
+            const validated = parseResult.data;
+            const trip = {
+                id: validated.trip_id,
+                routeId: validated.route_id,
+                serviceId: validated.service_id,
+                headsign: cleanTextField(validated.trip_headsign),
+                directionId: validated.direction_id ?? null,
+                shapeId: validated.shape_id ?? null,
+                blockId: validated.block_id ?? null,
+            };
+            trips.set(trip.id, trip);
+        }
+        catch {
+            continue;
+        }
+    }
+    return trips;
+}
+// =============================================================================
+// Shapes Parser
+// =============================================================================
+/**
+ * Parse shapes.txt content into a Map grouped by shape_id.
+ * Points within each shape are sorted by sequence.
+ *
+ * @param content - Raw shapes.txt content
+ * @returns Map from shape_id to array of ShapePoint objects
+ */
+export function parseShapesContent(content) {
+    const lines = content.split('\n').filter(line => line.trim());
+    if (lines.length < 2) {
+        return new Map();
+    }
+    const firstLine = lines[0];
+    if (firstLine === undefined || firstLine === '') {
+        return new Map();
+    }
+    const headers = parseCSVLine(firstLine);
+    const headerMap = buildHeaderMap(headers);
+    const shapes = new Map();
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line === '')
+            continue;
+        const row = parseCSVLine(line);
+        try {
+            const rowObject = buildRowObject(row, headerMap);
+            const parseResult = gtfsShapeSchema.safeParse(rowObject);
+            if (!parseResult.success) {
+                continue;
+            }
+            const validated = parseResult.data;
+            const point = {
+                shapeId: validated.shape_id,
+                latitude: validated.shape_pt_lat,
+                longitude: validated.shape_pt_lon,
+                sequence: validated.shape_pt_sequence,
+                distanceTraveled: validated.shape_dist_traveled ?? null,
+            };
+            const existing = shapes.get(point.shapeId);
+            if (existing !== undefined) {
+                existing.push(point);
+            }
+            else {
+                shapes.set(point.shapeId, [point]);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Sort points within each shape by sequence
+    for (const points of shapes.values()) {
+        points.sort((a, b) => a.sequence - b.sequence);
+    }
+    return shapes;
+}
+// =============================================================================
+// Calendar Parser
+// =============================================================================
+/**
+ * Helper to parse GTFS date format (YYYYMMDD) to ISO format (YYYY-MM-DD).
+ */
+function parseGtfsDate(dateStr) {
+    if (dateStr.length !== 8)
+        return dateStr;
+    return `${dateStr.slice(0, 4)}-${dateStr.slice(4, 6)}-${dateStr.slice(6, 8)}`;
+}
+/**
+ * Parse calendar.txt content into a Map keyed by service_id.
+ *
+ * @param content - Raw calendar.txt content
+ * @returns Map from service_id to Calendar object
+ */
+export function parseCalendarContent(content) {
+    const lines = content.split('\n').filter(line => line.trim());
+    if (lines.length < 2) {
+        return new Map();
+    }
+    const firstLine = lines[0];
+    if (firstLine === undefined || firstLine === '') {
+        return new Map();
+    }
+    const headers = parseCSVLine(firstLine);
+    const headerMap = buildHeaderMap(headers);
+    const calendars = new Map();
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line === '')
+            continue;
+        const row = parseCSVLine(line);
+        try {
+            const rowObject = buildRowObject(row, headerMap);
+            const parseResult = gtfsCalendarSchema.safeParse(rowObject);
+            if (!parseResult.success) {
+                continue;
+            }
+            const validated = parseResult.data;
+            const calendar = {
+                serviceId: validated.service_id,
+                monday: validated.monday === 1,
+                tuesday: validated.tuesday === 1,
+                wednesday: validated.wednesday === 1,
+                thursday: validated.thursday === 1,
+                friday: validated.friday === 1,
+                saturday: validated.saturday === 1,
+                sunday: validated.sunday === 1,
+                startDate: parseGtfsDate(validated.start_date),
+                endDate: parseGtfsDate(validated.end_date),
+            };
+            calendars.set(calendar.serviceId, calendar);
+        }
+        catch {
+            continue;
+        }
+    }
+    return calendars;
+}
+// =============================================================================
+// Calendar Dates Parser
+// =============================================================================
+/**
+ * Parse calendar_dates.txt content into an array of CalendarDate objects.
+ *
+ * @param content - Raw calendar_dates.txt content
+ * @returns Array of CalendarDate objects
+ */
+export function parseCalendarDatesContent(content) {
+    const lines = content.split('\n').filter(line => line.trim());
+    if (lines.length < 2) {
+        return [];
+    }
+    const firstLine = lines[0];
+    if (firstLine === undefined || firstLine === '') {
+        return [];
+    }
+    const headers = parseCSVLine(firstLine);
+    const headerMap = buildHeaderMap(headers);
+    const calendarDates = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line === '')
+            continue;
+        const row = parseCSVLine(line);
+        try {
+            const rowObject = buildRowObject(row, headerMap);
+            const parseResult = gtfsCalendarDateSchema.safeParse(rowObject);
+            if (!parseResult.success) {
+                continue;
+            }
+            const validated = parseResult.data;
+            calendarDates.push({
+                serviceId: validated.service_id,
+                date: parseGtfsDate(validated.date),
+                exceptionType: validated.exception_type === 1 ? 'added' : 'removed',
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return calendarDates;
+}
+// =============================================================================
+// Agency Parser
+// =============================================================================
+/**
+ * Parse agency.txt content into an array of Agency objects.
+ *
+ * @param content - Raw agency.txt content
+ * @returns Array of Agency objects
+ */
+export function parseAgencyContent(content) {
+    const lines = content.split('\n').filter(line => line.trim());
+    if (lines.length < 2) {
+        return [];
+    }
+    const firstLine = lines[0];
+    if (firstLine === undefined || firstLine === '') {
+        return [];
+    }
+    const headers = parseCSVLine(firstLine);
+    const headerMap = buildHeaderMap(headers);
+    const agencies = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line === '')
+            continue;
+        const row = parseCSVLine(line);
+        try {
+            const rowObject = buildRowObject(row, headerMap);
+            const parseResult = gtfsAgencySchema.safeParse(rowObject);
+            if (!parseResult.success) {
+                continue;
+            }
+            const validated = parseResult.data;
+            agencies.push({
+                id: validated.agency_id ?? '',
+                name: cleanTextField(validated.agency_name),
+                url: validated.agency_url,
+                timezone: validated.agency_timezone,
+                language: validated.agency_lang ?? null,
+                phone: validated.agency_phone ?? null,
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return agencies;
+}
+// =============================================================================
+// Stop Times Parser
+// =============================================================================
+/**
+ * Parse stop_times.txt content into a Map grouped by trip_id.
+ * Stop times within each trip are sorted by sequence.
+ *
+ * Note: This file can be large (~25MB for Vilnius). Use appropriate memory management.
+ *
+ * @param content - Raw stop_times.txt content
+ * @returns Map from trip_id to array of StopTime objects
+ */
+export function parseStopTimesContent(content) {
+    const lines = content.split('\n').filter(line => line.trim());
+    if (lines.length < 2) {
+        return new Map();
+    }
+    const firstLine = lines[0];
+    if (firstLine === undefined || firstLine === '') {
+        return new Map();
+    }
+    const headers = parseCSVLine(firstLine);
+    const headerMap = buildHeaderMap(headers);
+    const stopTimes = new Map();
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined || line === '')
+            continue;
+        const row = parseCSVLine(line);
+        try {
+            const rowObject = buildRowObject(row, headerMap);
+            const parseResult = gtfsStopTimeSchema.safeParse(rowObject);
+            if (!parseResult.success) {
+                continue;
+            }
+            const validated = parseResult.data;
+            const stopTime = {
+                tripId: validated.trip_id,
+                stopId: validated.stop_id,
+                arrivalTime: validated.arrival_time,
+                departureTime: validated.departure_time,
+                sequence: validated.stop_sequence,
+                headsign: validated.stop_headsign ?? null,
+            };
+            const existing = stopTimes.get(stopTime.tripId);
+            if (existing !== undefined) {
+                existing.push(stopTime);
+            }
+            else {
+                stopTimes.set(stopTime.tripId, [stopTime]);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Sort stop times within each trip by sequence
+    for (const times of stopTimes.values()) {
+        times.sort((a, b) => a.sequence - b.sequence);
+    }
+    return stopTimes;
+}
 //# sourceMappingURL=parser.js.map