lt-public-transport-sdk 1.0.0

package/dist/config.js

@@ -0,0 +1,200 @@
+/**
+ * City configuration matrix for Lithuanian Public Transport SDK
+ * @module config
+ */
+// =============================================================================
+// City Configuration Matrix
+// =============================================================================
+/**
+ * Base URL for stops.lt infrastructure.
+ */
+const BASE_URL = 'https://www.stops.lt';
+/**
+ * Helper to build GPS full URL.
+ */
+function gpsFullUrl(city) {
+    return `${BASE_URL}/${city}/gps_full.txt`;
+}
+/**
+ * Helper to build GPS lite URL.
+ */
+function gpsLiteUrl(city) {
+    return `${BASE_URL}/${city}/gps.txt`;
+}
+/**
+ * Helper to build GTFS URL.
+ * Note: URL pattern uses double city name: /city/city/gtfs.zip
+ */
+function gtfsUrl(city) {
+    return `${BASE_URL}/${city}/${city}/gtfs.zip`;
+}
+/**
+ * City configuration matrix with all supported cities.
+ *
+ * Data Quality Tiers:
+ * - Gold: Full GPS streams with 12-18 columns including destination, delay, equipment
+ * - Silver: Lite GPS streams with 8-9 columns, requires GTFS enrichment for destinations
+ * - Bronze: GTFS only, no real-time GPS data available
+ *
+ * Column Counts (empirically verified 2026-01-05):
+ * - Vilnius: 18 columns (MatavimoLaikas, KryptiesTipas, ReisoIdGTFS)
+ * - Kaunas: 14 columns (Grafikas, SekanciosStotelesNum, AtvykimoLaikasSekundemis - NO MatavimoLaikas)
+ * - Klaipėda: 12 columns (minimal format)
+ * - Alytus: 13 columns
+ * - Druskininkai: 13 columns
+ * - Panevėžys: 9 columns lite (no header)
+ * - Tauragė: 8 columns lite (no header, alphanumeric routes like S11)
+ */
+const CITY_CONFIGS_INTERNAL = {
+    vilnius: {
+        id: 'vilnius',
+        tier: 'gold',
+        gps: {
+            enabled: true,
+            format: 'full',
+            url: gpsFullUrl('vilnius'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('vilnius'),
+        },
+    },
+    kaunas: {
+        id: 'kaunas',
+        tier: 'gold',
+        gps: {
+            enabled: true,
+            format: 'full',
+            url: gpsFullUrl('kaunas'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('kaunas'),
+        },
+    },
+    klaipeda: {
+        id: 'klaipeda',
+        tier: 'gold',
+        gps: {
+            enabled: true,
+            format: 'full',
+            url: gpsFullUrl('klaipeda'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('klaipeda'),
+        },
+    },
+    alytus: {
+        id: 'alytus',
+        tier: 'gold',
+        gps: {
+            enabled: true,
+            format: 'full',
+            url: gpsFullUrl('alytus'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('alytus'),
+        },
+    },
+    druskininkai: {
+        id: 'druskininkai',
+        tier: 'gold',
+        gps: {
+            enabled: true,
+            format: 'full',
+            url: gpsFullUrl('druskininkai'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('druskininkai'),
+        },
+    },
+    panevezys: {
+        id: 'panevezys',
+        tier: 'silver',
+        gps: {
+            enabled: true,
+            format: 'lite',
+            url: gpsLiteUrl('panevezys'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('panevezys'),
+        },
+    },
+    taurage: {
+        id: 'taurage',
+        tier: 'silver',
+        gps: {
+            enabled: true,
+            format: 'lite',
+            url: gpsLiteUrl('taurage'),
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('taurage'),
+        },
+    },
+    siauliai: {
+        id: 'siauliai',
+        tier: 'bronze',
+        gps: {
+            enabled: false,
+            format: null,
+            url: null,
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('siauliai'),
+        },
+    },
+    utena: {
+        id: 'utena',
+        tier: 'bronze',
+        gps: {
+            enabled: false,
+            format: null,
+            url: null,
+        },
+        gtfs: {
+            enabled: true,
+            url: gtfsUrl('utena'),
+        },
+    },
+};
+/**
+ * City configuration matrix with all supported cities.
+ */
+export const CITY_CONFIGS = CITY_CONFIGS_INTERNAL;
+/**
+ * List of all supported city IDs.
+ */
+export const ALL_CITY_IDS = Object.keys(CITY_CONFIGS);
+/**
+ * Get configuration for a specific city.
+ * @throws Error if city ID is invalid
+ */
+export function getCityConfig(city) {
+    return CITY_CONFIGS[city];
+}
+/**
+ * Get all cities of a specific tier.
+ */
+export function getCitiesByTier(tier) {
+    return ALL_CITY_IDS.filter(city => CITY_CONFIGS[city].tier === tier);
+}
+/**
+ * Check if a city has GPS data available.
+ */
+export function hasGpsData(city) {
+    return CITY_CONFIGS[city].gps.enabled;
+}
+/**
+ * Check if a city has GTFS data available.
+ */
+export function hasGtfsData(city) {
+    return CITY_CONFIGS[city].gtfs.enabled;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqEH,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,GAAG,QAAQ,IAAI,IAAI,eAAe,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,GAAG,QAAQ,IAAI,IAAI,UAAU,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,GAAG,QAAQ,IAAI,IAAI,IAAI,IAAI,WAAW,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,qBAAqB,GAAG;IAC5B,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC;SAC3B;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC;SACxB;KACF;IAED,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC;SAC1B;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC;SACvB;KACF;IAED,QAAQ,EAAE;QACR,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC;SAC5B;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC;SACzB;KACF;IAED,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC;SAC1B;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC;SACvB;KACF;IAED,YAAY,EAAE;QACZ,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,cAAc,CAAC;SAChC;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC;SAC7B;KACF;IAED,SAAS,EAAE;QACT,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC;SAC7B;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;SAC1B;KACF;IAED,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC;SAC3B;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC;SACxB;KACF;IAED,QAAQ,EAAE;QACR,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE;YACH,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,IAAI;SACV;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC;SACzB;KACF;IAED,KAAK,EAAE;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE;YACH,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,IAAI;SACV;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;SACtB;KACF;CACO,CAAC;AAQX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAyC,qBAAqB,CAAC;AAExF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAa,CAAC;AAErF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;AACzC,CAAC"}

package/dist/enrichment/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Enrichment module exports
+ * @module enrichment
+ */
+export { matchRoute, enrichVehicle, enrichVehicles, type EnrichmentResult, } from './route-matcher.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC"}

package/dist/enrichment/index.js

@@ -0,0 +1,6 @@
+/**
+ * Enrichment module exports
+ * @module enrichment
+ */
+export { matchRoute, enrichVehicle, enrichVehicles, } from './route-matcher.js';
+//# sourceMappingURL=index.js.map

package/dist/enrichment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enrichment/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,GAEf,MAAM,oBAAoB,CAAC"}

package/dist/enrichment/route-matcher.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Route matching and data enrichment for silver-tier cities
+ * @module enrichment/route-matcher
+ *
+ * Silver-tier cities (Panevėžys, Tauragė) provide lite GPS streams
+ * that lack destination and route long name. This module enriches
+ * vehicles with data from GTFS routes.
+ */
+import type { Route, Vehicle } from '../types.js';
+/**
+ * Result of route enrichment lookup.
+ */
+export interface EnrichmentResult {
+    /** Destination/terminus name from route long name */
+    destination: string | null;
+    /** Full route name */
+    routeLongName: string | null;
+    /** Whether a match was found */
+    matched: boolean;
+}
+/**
+ * Route cache with O(1) case-insensitive lookup.
+ * The normalized map uses uppercase keys for fast matching.
+ */
+export interface RouteCache {
+    /** Primary map: exact short name -> Route */
+    readonly routes: Map<string, Route>;
+    /** Normalized map: uppercase short name -> Route (for O(1) case-insensitive lookup) */
+    readonly normalizedRoutes: Map<string, Route>;
+}
+/**
+ * Build a RouteCache from a routes map.
+ * Pre-builds the normalized (uppercase) lookup map.
+ */
+export declare function buildRouteCache(routes: Map<string, Route>): RouteCache;
+/**
+ * Match a GPS route to GTFS route data.
+ *
+ * Matching strategy:
+ * 1. Exact match on route short name (case-sensitive) - O(1)
+ * 2. Case-insensitive match via normalized map - O(1)
+ *
+ * @param gpsRoute - Route identifier from GPS stream
+ * @param cache - RouteCache with pre-built normalized lookup
+ * @returns Enrichment result with destination and route name
+ */
+export declare function matchRoute(gpsRoute: string, cache: RouteCache): EnrichmentResult;
+/**
+ * Enrich a vehicle with GTFS route data.
+ *
+ * @param vehicle - Vehicle to enrich
+ * @param cache - RouteCache with pre-built normalized lookup
+ * @returns New vehicle with enriched data (or original if no match)
+ */
+export declare function enrichVehicle(vehicle: Vehicle, cache: RouteCache): Vehicle;
+/**
+ * Enrich an array of vehicles with GTFS route data.
+ *
+ * @param vehicles - Vehicles to enrich
+ * @param cache - RouteCache with pre-built normalized lookup
+ * @returns New array with enriched vehicles
+ */
+export declare function enrichVehicles(vehicles: Vehicle[], cache: RouteCache): Vehicle[];
+//# sourceMappingURL=route-matcher.d.ts.map

package/dist/enrichment/route-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.d.ts","sourceRoot":"","sources":["../../src/enrichment/route-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,sBAAsB;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,uFAAuF;IACvF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,UAAU,CAQtE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,GAChB,gBAAgB,CAsBlB;AA6CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,GAChB,OAAO,CAiBT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,UAAU,GAChB,OAAO,EAAE,CAEX"}

package/dist/enrichment/route-matcher.js

@@ -0,0 +1,121 @@
+/**
+ * Route matching and data enrichment for silver-tier cities
+ * @module enrichment/route-matcher
+ *
+ * Silver-tier cities (Panevėžys, Tauragė) provide lite GPS streams
+ * that lack destination and route long name. This module enriches
+ * vehicles with data from GTFS routes.
+ */
+/**
+ * Build a RouteCache from a routes map.
+ * Pre-builds the normalized (uppercase) lookup map.
+ */
+export function buildRouteCache(routes) {
+    const normalizedRoutes = new Map();
+    for (const [key, route] of routes) {
+        normalizedRoutes.set(key.toUpperCase(), route);
+    }
+    return { routes, normalizedRoutes };
+}
+// =============================================================================
+// Route Matcher
+// =============================================================================
+/**
+ * Match a GPS route to GTFS route data.
+ *
+ * Matching strategy:
+ * 1. Exact match on route short name (case-sensitive) - O(1)
+ * 2. Case-insensitive match via normalized map - O(1)
+ *
+ * @param gpsRoute - Route identifier from GPS stream
+ * @param cache - RouteCache with pre-built normalized lookup
+ * @returns Enrichment result with destination and route name
+ */
+export function matchRoute(gpsRoute, cache) {
+    // Empty route - no enrichment possible
+    if (!gpsRoute || gpsRoute.trim() === '') {
+        return { destination: null, routeLongName: null, matched: false };
+    }
+    const normalized = gpsRoute.trim();
+    // 1. Try exact match - O(1)
+    const exactRoute = cache.routes.get(normalized);
+    if (exactRoute) {
+        return extractEnrichment(exactRoute);
+    }
+    // 2. Try case-insensitive match via normalized map - O(1)
+    const upperRoute = cache.normalizedRoutes.get(normalized.toUpperCase());
+    if (upperRoute) {
+        return extractEnrichment(upperRoute);
+    }
+    // 3. No match found
+    return { destination: null, routeLongName: null, matched: false };
+}
+/**
+ * Extract enrichment data from a matched route.
+ */
+function extractEnrichment(route) {
+    // Parse destination from long name
+    // Common patterns:
+    // - "Terminus A - Terminus B"
+    // - "Terminus A – Terminus B" (en-dash)
+    // - Just use the full long name if no separator
+    let destination = null;
+    if (route.longName !== '' && route.longName.length > 0) {
+        // Try to extract destination (usually after separator)
+        const separators = [' - ', ' – ', ' — ', ' / '];
+        for (const sep of separators) {
+            if (route.longName.includes(sep)) {
+                const parts = route.longName.split(sep);
+                const lastPart = parts[parts.length - 1];
+                // Use the last part as destination (typical direction)
+                if (lastPart !== undefined) {
+                    destination = lastPart.trim();
+                }
+                break;
+            }
+        }
+        // If no separator found, use full long name
+        destination ??= route.longName;
+    }
+    return {
+        destination,
+        routeLongName: route.longName !== '' ? route.longName : null,
+        matched: true,
+    };
+}
+// =============================================================================
+// Vehicle Enrichment
+// =============================================================================
+/**
+ * Enrich a vehicle with GTFS route data.
+ *
+ * @param vehicle - Vehicle to enrich
+ * @param cache - RouteCache with pre-built normalized lookup
+ * @returns New vehicle with enriched data (or original if no match)
+ */
+export function enrichVehicle(vehicle, cache) {
+    // Skip if already has destination
+    if (vehicle.destination !== null && vehicle.destination !== '') {
+        return vehicle;
+    }
+    const enrichment = matchRoute(vehicle.route, cache);
+    if (!enrichment.matched) {
+        return vehicle;
+    }
+    // Return new vehicle with enriched data
+    return {
+        ...vehicle,
+        destination: enrichment.destination,
+    };
+}
+/**
+ * Enrich an array of vehicles with GTFS route data.
+ *
+ * @param vehicles - Vehicles to enrich
+ * @param cache - RouteCache with pre-built normalized lookup
+ * @returns New array with enriched vehicles
+ */
+export function enrichVehicles(vehicles, cache) {
+    return vehicles.map(v => enrichVehicle(v, cache));
+}
+//# sourceMappingURL=route-matcher.js.map

package/dist/enrichment/route-matcher.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Custom error types for Lithuanian Public Transport SDK
+ * @module errors
+ */
+import type { CityId } from './types.js';
+/**
+ * Base error class for transport SDK errors.
+ */
+export declare abstract class TransportError extends Error {
+    /** City associated with this error, if applicable */
+    abstract readonly city: CityId | null;
+    constructor(message: string);
+}
+/**
+ * Error thrown when a network request fails.
+ */
+export declare class TransportNetworkError extends TransportError {
+    readonly cityId: CityId;
+    readonly statusCode?: number | undefined;
+    readonly cause?: Error | undefined;
+    readonly city: CityId;
+    constructor(message: string, cityId: CityId, statusCode?: number | undefined, cause?: Error | undefined);
+}
+/**
+ * Error thrown when GPS data is requested for a bronze-tier city.
+ */
+export declare class GpsNotAvailableError extends TransportError {
+    readonly city: CityId;
+    constructor(cityId: CityId);
+}
+/**
+ * Error thrown when GTFS data is required but not yet synced.
+ */
+export declare class SyncRequiredError extends TransportError {
+    readonly city: CityId;
+    constructor(cityId: CityId);
+}
+/**
+ * Error thrown when GTFS sync fails.
+ */
+export declare class GtfsSyncError extends TransportError {
+    readonly cause?: Error | undefined;
+    readonly city: CityId;
+    constructor(cityId: CityId, message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when parsing GPS or GTFS data fails.
+ */
+export declare class ParseError extends TransportError {
+    readonly line?: number | undefined;
+    readonly rawData?: string | undefined;
+    readonly city: CityId | null;
+    constructor(message: string, cityId?: CityId, line?: number | undefined, rawData?: string | undefined);
+}
+/**
+ * Error thrown when an invalid city ID is provided.
+ */
+export declare class InvalidCityError extends TransportError {
+    readonly city: null;
+    constructor(providedCity: string);
+}
+/**
+ * Type guard to check if an error is a TransportError.
+ */
+export declare function isTransportError(error: unknown): error is TransportError;
+/**
+ * Type guard to check if an error is a network error.
+ */
+export declare function isNetworkError(error: unknown): error is TransportNetworkError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,8BAAsB,cAAe,SAAQ,KAAK;IAChD,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE1B,OAAO,EAAE,MAAM;CAQ5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;aAKrC,MAAM,EAAE,MAAM;aACd,UAAU,CAAC,EAAE,MAAM;aACnB,KAAK,CAAC,EAAE,KAAK;IAN/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;aAM7B,KAAK,CAAC,EAAE,KAAK;IAL/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,cAAc;aAM1B,IAAI,CAAC,EAAE,MAAM;aACb,OAAO,CAAC,EAAE,MAAM;IANlC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,MAAM,YAAA;CAQnC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,IAAI,OAAQ;gBAET,YAAY,EAAE,MAAM;CAGjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE7E"}

package/dist/errors.js

@@ -0,0 +1,104 @@
+/**
+ * Custom error types for Lithuanian Public Transport SDK
+ * @module errors
+ */
+/**
+ * Base error class for transport SDK errors.
+ */
+export class TransportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        // Maintains proper stack trace for where error was thrown (V8 engines)
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * Error thrown when a network request fails.
+ */
+export class TransportNetworkError extends TransportError {
+    cityId;
+    statusCode;
+    cause;
+    city;
+    constructor(message, cityId, statusCode, cause) {
+        super(message);
+        this.cityId = cityId;
+        this.statusCode = statusCode;
+        this.cause = cause;
+        this.city = cityId;
+    }
+}
+/**
+ * Error thrown when GPS data is requested for a bronze-tier city.
+ */
+export class GpsNotAvailableError extends TransportError {
+    city;
+    constructor(cityId) {
+        super(`GPS data is not available for ${cityId} (bronze tier city). Use GTFS static data instead.`);
+        this.city = cityId;
+    }
+}
+/**
+ * Error thrown when GTFS data is required but not yet synced.
+ */
+export class SyncRequiredError extends TransportError {
+    city;
+    constructor(cityId) {
+        super(`GTFS data for ${cityId} is not synced. Call sync('${cityId}') first.`);
+        this.city = cityId;
+    }
+}
+/**
+ * Error thrown when GTFS sync fails.
+ */
+export class GtfsSyncError extends TransportError {
+    cause;
+    city;
+    constructor(cityId, message, cause) {
+        super(`GTFS sync failed for ${cityId}: ${message}`);
+        this.cause = cause;
+        this.city = cityId;
+    }
+}
+/**
+ * Error thrown when parsing GPS or GTFS data fails.
+ */
+export class ParseError extends TransportError {
+    line;
+    rawData;
+    city;
+    constructor(message, cityId, line, rawData) {
+        const fullMessage = cityId !== undefined
+            ? `Parse error for ${cityId}${line !== undefined ? ` at line ${String(line)}` : ''}: ${message}`
+            : `Parse error: ${message}`;
+        super(fullMessage);
+        this.line = line;
+        this.rawData = rawData;
+        this.city = cityId ?? null;
+    }
+}
+/**
+ * Error thrown when an invalid city ID is provided.
+ */
+export class InvalidCityError extends TransportError {
+    city = null;
+    constructor(providedCity) {
+        super(`Invalid city ID: '${providedCity}'. See ALL_CITY_IDS for valid options.`);
+    }
+}
+/**
+ * Type guard to check if an error is a TransportError.
+ */
+export function isTransportError(error) {
+    return error instanceof TransportError;
+}
+/**
+ * Type guard to check if an error is a network error.
+ */
+export function isNetworkError(error) {
+    return error instanceof TransportNetworkError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,OAAgB,cAAe,SAAQ,KAAK;IAIhD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,uEAAuE;QACvE,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAClD,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IAKrC;IACA;IACA;IANT,IAAI,CAAS;IAEtB,YACE,OAAe,EACC,MAAc,EACd,UAAmB,EACnB,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAS;QACnB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IAC7C,IAAI,CAAS;IAEtB,YAAY,MAAc;QACxB,KAAK,CAAC,iCAAiC,MAAM,oDAAoD,CAAC,CAAC;QACnG,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IAC1C,IAAI,CAAS;IAEtB,YAAY,MAAc;QACxB,KAAK,CAAC,iBAAiB,MAAM,8BAA8B,MAAM,WAAW,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAM7B;IALT,IAAI,CAAS;IAEtB,YACE,MAAc,EACd,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,wBAAwB,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QAFpC,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAM1B;IACA;IANT,IAAI,CAAgB;IAE7B,YACE,OAAe,EACf,MAAe,EACC,IAAa,EACb,OAAgB;QAEhC,MAAM,WAAW,GAAG,MAAM,KAAK,SAAS;YACtC,CAAC,CAAC,mBAAmB,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE;YAChG,CAAC,CAAC,gBAAgB,OAAO,EAAE,CAAC;QAC9B,KAAK,CAAC,WAAW,CAAC,CAAC;QANH,SAAI,GAAJ,IAAI,CAAS;QACb,YAAO,GAAP,OAAO,CAAS;QAMhC,IAAI,CAAC,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACzC,IAAI,GAAG,IAAI,CAAC;IAErB,YAAY,YAAoB;QAC9B,KAAK,CAAC,qBAAqB,YAAY,wCAAwC,CAAC,CAAC;IACnF,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,qBAAqB,CAAC;AAChD,CAAC"}

package/dist/gtfs/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GTFS module exports
+ * @module gtfs
+ */
+export { parseRoutesContent, parseStopsContent, } from './parser.js';
+export { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops, type SyncOptions, type GtfsCache, } from './sync.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/gtfs/index.js

@@ -0,0 +1,7 @@
+/**
+ * GTFS module exports
+ * @module gtfs
+ */
+export { parseRoutesContent, parseStopsContent, } from './parser.js';
+export { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops, } from './sync.js';
+//# sourceMappingURL=index.js.map

package/dist/gtfs/index.js.map

@@ -0,0 +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"}

package/dist/gtfs/parser.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GTFS file parsers for routes.txt and stops.txt
+ * @module gtfs/parser
+ */
+import type { Route, Stop } from '../types.js';
+/**
+ * Parse routes.txt content into a Map keyed by route short name.
+ *
+ * GTFS routes.txt fields:
+ * - route_id: Unique identifier
+ * - agency_id: Agency reference
+ * - route_short_name: Short name (e.g., "4G", "N1")
+ * - route_long_name: Full name with endpoints
+ * - route_desc: Description
+ * - route_type: GTFS route type (3=bus, 800=trolleybus)
+ * - route_url: URL
+ * - route_color: Background color (hex)
+ * - route_text_color: Text color (hex)
+ *
+ * @param content - Raw routes.txt content
+ * @returns Map from route short name to Route object
+ */
+export declare function parseRoutesContent(content: string): Map<string, Route>;
+/**
+ * Parse stops.txt content into an array of Stop objects.
+ *
+ * GTFS stops.txt fields:
+ * - stop_id: Unique identifier
+ * - stop_code: Short code
+ * - stop_name: Human-readable name
+ * - stop_desc: Description
+ * - stop_lat: Latitude
+ * - stop_lon: Longitude
+ *
+ * @param content - Raw stops.txt content
+ * @returns Array of Stop objects
+ */
+export declare function parseStopsContent(content: string): Stop[];
+//# sourceMappingURL=parser.d.ts.map