lt-public-transport-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Lithuanian Public Transport SDK
+ *
+ * A production-grade TypeScript SDK for accessing real-time Lithuanian
+ * public transport data from stops.lt infrastructure.
+ *
+ * @example
+ * ```typescript
+ * import { LtTransport } from 'lt-public-transport-sdk';
+ *
+ * const transport = new LtTransport();
+ *
+ * // Sync GTFS data (required for enrichment)
+ * await transport.sync('vilnius');
+ *
+ * // Get real-time vehicle positions
+ * const vehicles = await transport.getVehicles('vilnius');
+ *
+ * // Get static stop data
+ * const stops = await transport.getStops('vilnius');
+ * ```
+ *
+ * @module
+ */
+import type { CityId, Route, Stop, SyncResult, Vehicle } from './types.js';
+import { type CityConfig } from './config.js';
+/**
+ * Configuration options for LtTransport client.
+ */
+export interface LtTransportConfig {
+    /**
+     * Directory for caching GTFS data.
+     * Defaults to system temp directory.
+     */
+    cacheDir?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 10000
+     */
+    requestTimeout?: number;
+    /**
+     * User-Agent header for HTTP requests.
+     * @default 'lt-public-transport-sdk/1.0.0'
+     */
+    userAgent?: string;
+    /**
+     * Threshold in milliseconds for marking data as stale.
+     * @default 300000 (5 minutes)
+     */
+    staleThresholdMs?: number;
+    /**
+     * Whether to automatically enrich silver-tier cities with GTFS data.
+     * Requires prior sync() call for the city.
+     * @default true
+     */
+    autoEnrich?: boolean;
+    /**
+     * Whether to filter out vehicles with invalid (out of Lithuania) coordinates.
+     * @default true
+     */
+    filterInvalidCoords?: boolean;
+    /**
+     * Whether to filter out stale data.
+     * @default false
+     */
+    filterStale?: boolean;
+}
+/**
+ * Lithuanian Public Transport SDK client.
+ *
+ * Provides unified access to real-time GPS vehicle positions and
+ * static GTFS data for Lithuanian cities.
+ *
+ * @example
+ * ```typescript
+ * const transport = new LtTransport();
+ *
+ * // Get vehicles from Vilnius (gold tier - rich data)
+ * const vilniusVehicles = await transport.getVehicles('vilnius');
+ *
+ * // Get vehicles from Panevėžys (silver tier - needs enrichment)
+ * await transport.sync('panevezys'); // Sync GTFS first
+ * const panevezysVehicles = await transport.getVehicles('panevezys');
+ * ```
+ */
+export declare class LtTransport {
+    private readonly cacheDir;
+    private readonly requestTimeout;
+    private readonly userAgent;
+    private readonly staleThresholdMs;
+    private readonly autoEnrich;
+    private readonly filterInvalidCoords;
+    private readonly filterStale;
+    /** In-memory route cache for fast enrichment */
+    private readonly routeCaches;
+    /** Last sync timestamps for throttling */
+    private readonly lastSyncTimes;
+    /**
+     * Create a new LtTransport client.
+     *
+     * @param config - Client configuration options
+     */
+    constructor(config?: LtTransportConfig);
+    /**
+     * Get real-time vehicle positions for a city.
+     *
+     * For silver-tier cities (Panevėžys, Tauragė), vehicles will be enriched
+     * with GTFS data if `sync()` has been called and `autoEnrich` is enabled.
+     *
+     * @param city - City identifier
+     * @returns Array of vehicle positions
+     * @throws {GpsNotAvailableError} If city is bronze tier (no GPS data)
+     * @throws {TransportNetworkError} If network request fails
+     *
+     * @example
+     * ```typescript
+     * const vehicles = await transport.getVehicles('vilnius');
+     * console.log(`Found ${vehicles.length} vehicles`);
+     * ```
+     */
+    getVehicles(city: CityId): Promise<Vehicle[]>;
+    /**
+     * Sync GTFS static data for a city.
+     *
+     * Downloads the GTFS ZIP archive if newer than cached version,
+     * extracts routes and stops, and caches for future use.
+     *
+     * Throttled to minimum 60 seconds between calls for same city.
+     *
+     * @param city - City to sync
+     * @param force - Force re-download even if cache is current
+     * @returns Sync result with counts and status
+     * @throws {GtfsSyncError} If sync fails
+     *
+     * @example
+     * ```typescript
+     * const result = await transport.sync('vilnius');
+     * console.log(`Synced ${result.routeCount} routes`);
+     * ```
+     */
+    sync(city: CityId, force?: boolean): Promise<SyncResult>;
+    /**
+     * Get static stop data for a city.
+     *
+     * Requires prior `sync()` call to download GTFS data.
+     *
+     * @param city - City to get stops for
+     * @returns Array of stops
+     * @throws {SyncRequiredError} If GTFS data not synced
+     *
+     * @example
+     * ```typescript
+     * await transport.sync('vilnius');
+     * const stops = await transport.getStops('vilnius');
+     * console.log(`Found ${stops.length} stops`);
+     * ```
+     */
+    getStops(city: CityId): Promise<Stop[]>;
+    /**
+     * Get route information for a city.
+     *
+     * Requires prior `sync()` call to download GTFS data.
+     *
+     * @param city - City to get routes for
+     * @returns Array of routes
+     * @throws {SyncRequiredError} If GTFS data not synced
+     *
+     * @example
+     * ```typescript
+     * await transport.sync('vilnius');
+     * const routes = await transport.getRoutes('vilnius');
+     * console.log(`Found ${routes.length} routes`);
+     * ```
+     */
+    getRoutes(city: CityId): Promise<Route[]>;
+    /**
+     * Get list of all supported city IDs.
+     */
+    getCities(): readonly CityId[];
+    /**
+     * Get configuration for a specific city.
+     */
+    getCityConfig(city: CityId): CityConfig;
+    /**
+     * Validate that city ID is valid.
+     */
+    private validateCity;
+    /**
+     * Fetch text content from URL.
+     */
+    private fetchText;
+    /**
+     * Get route cache for a city, loading from disk if needed.
+     */
+    private getRouteCache;
+}
+export type { CityId, CityTier, VehicleType, Vehicle, Stop, Route, SyncResult, } from './types.js';
+export { GTFS_ROUTE_TYPE_MAP, LT_TRANSPORT_TYPE_MAP } from './types.js';
+export { CITY_CONFIGS, ALL_CITY_IDS, getCityConfig, getCitiesByTier, hasGpsData, hasGtfsData } from './config.js';
+export type { CityConfig, GpsConfig, GtfsConfig } from './config.js';
+export { TransportError, TransportNetworkError, GpsNotAvailableError, SyncRequiredError, GtfsSyncError, ParseError, InvalidCityError, isTransportError, isNetworkError, } from './errors.js';
+export { normalizeCoordinate, isValidLithuaniaCoord, LITHUANIA_BOUNDS, repairMojibake, secondsFromMidnightToDate, isDataStale, } from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,342 @@
+/**
+ * Lithuanian Public Transport SDK
+ *
+ * A production-grade TypeScript SDK for accessing real-time Lithuanian
+ * public transport data from stops.lt infrastructure.
+ *
+ * @example
+ * ```typescript
+ * import { LtTransport } from 'lt-public-transport-sdk';
+ *
+ * const transport = new LtTransport();
+ *
+ * // Sync GTFS data (required for enrichment)
+ * await transport.sync('vilnius');
+ *
+ * // Get real-time vehicle positions
+ * const vehicles = await transport.getVehicles('vilnius');
+ *
+ * // Get static stop data
+ * const stops = await transport.getStops('vilnius');
+ * ```
+ *
+ * @module
+ */
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { CITY_CONFIGS, getCityConfig, ALL_CITY_IDS } from './config.js';
+import { TransportNetworkError, GpsNotAvailableError, SyncRequiredError, InvalidCityError, } from './errors.js';
+import { parseGpsFullStream } from './parsers/gps-full.js';
+import { parseGpsLiteStream, isLiteCity } from './parsers/gps-lite.js';
+import { syncGtfs, loadGtfsCache, loadCachedRoutes, loadCachedStops } from './gtfs/sync.js';
+import { enrichVehicles, buildRouteCache } from './enrichment/route-matcher.js';
+import { clientConfigSchema } from './schemas.js';
+// =============================================================================
+// Default Values
+// =============================================================================
+const DEFAULT_TIMEOUT = 10000;
+const DEFAULT_USER_AGENT = 'lt-public-transport-sdk/1.0.0';
+const DEFAULT_STALE_THRESHOLD = 5 * 60 * 1000; // 5 minutes
+/**
+ * Get default cache directory.
+ */
+function getDefaultCacheDir() {
+    return join(tmpdir(), 'lt-transport-sdk-cache');
+}
+// =============================================================================
+// Main Client Class
+// =============================================================================
+/**
+ * Lithuanian Public Transport SDK client.
+ *
+ * Provides unified access to real-time GPS vehicle positions and
+ * static GTFS data for Lithuanian cities.
+ *
+ * @example
+ * ```typescript
+ * const transport = new LtTransport();
+ *
+ * // Get vehicles from Vilnius (gold tier - rich data)
+ * const vilniusVehicles = await transport.getVehicles('vilnius');
+ *
+ * // Get vehicles from Panevėžys (silver tier - needs enrichment)
+ * await transport.sync('panevezys'); // Sync GTFS first
+ * const panevezysVehicles = await transport.getVehicles('panevezys');
+ * ```
+ */
+export class LtTransport {
+    cacheDir;
+    requestTimeout;
+    userAgent;
+    staleThresholdMs;
+    autoEnrich;
+    filterInvalidCoords;
+    filterStale;
+    /** In-memory route cache for fast enrichment */
+    routeCaches = new Map();
+    /** Last sync timestamps for throttling */
+    lastSyncTimes = new Map();
+    /**
+     * Create a new LtTransport client.
+     *
+     * @param config - Client configuration options
+     */
+    constructor(config = {}) {
+        // Validate config with Zod schema for runtime safety
+        const validated = clientConfigSchema.parse({
+            cacheDir: config.cacheDir,
+            requestTimeout: config.requestTimeout ?? DEFAULT_TIMEOUT,
+            userAgent: config.userAgent ?? DEFAULT_USER_AGENT,
+            staleThresholdMs: config.staleThresholdMs ?? DEFAULT_STALE_THRESHOLD,
+            autoEnrich: config.autoEnrich ?? true,
+            filterInvalidCoords: config.filterInvalidCoords ?? true,
+            filterStale: config.filterStale ?? false,
+        });
+        this.cacheDir = validated.cacheDir ?? getDefaultCacheDir();
+        this.requestTimeout = validated.requestTimeout;
+        this.userAgent = validated.userAgent;
+        this.staleThresholdMs = validated.staleThresholdMs;
+        this.autoEnrich = validated.autoEnrich;
+        this.filterInvalidCoords = validated.filterInvalidCoords;
+        this.filterStale = validated.filterStale;
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /**
+     * Get real-time vehicle positions for a city.
+     *
+     * For silver-tier cities (Panevėžys, Tauragė), vehicles will be enriched
+     * with GTFS data if `sync()` has been called and `autoEnrich` is enabled.
+     *
+     * @param city - City identifier
+     * @returns Array of vehicle positions
+     * @throws {GpsNotAvailableError} If city is bronze tier (no GPS data)
+     * @throws {TransportNetworkError} If network request fails
+     *
+     * @example
+     * ```typescript
+     * const vehicles = await transport.getVehicles('vilnius');
+     * console.log(`Found ${vehicles.length} vehicles`);
+     * ```
+     */
+    async getVehicles(city) {
+        this.validateCity(city);
+        const config = getCityConfig(city);
+        if (!config.gps.enabled || config.gps.url === null) {
+            throw new GpsNotAvailableError(city);
+        }
+        // Fetch GPS data
+        const text = await this.fetchText(config.gps.url, city);
+        // Parse based on format
+        let vehicles;
+        if (config.gps.format === 'full') {
+            vehicles = parseGpsFullStream(text, city, {
+                staleThresholdMs: this.staleThresholdMs,
+                filterStale: this.filterStale,
+                filterInvalidCoords: this.filterInvalidCoords,
+            });
+        }
+        else if (isLiteCity(city)) {
+            vehicles = parseGpsLiteStream(text, city, {
+                filterInvalidCoords: this.filterInvalidCoords,
+            });
+            // Enrich silver-tier cities with GTFS data
+            if (this.autoEnrich) {
+                const routeCache = await this.getRouteCache(city);
+                if (routeCache) {
+                    vehicles = enrichVehicles(vehicles, routeCache);
+                }
+            }
+        }
+        else {
+            // Unknown format
+            vehicles = [];
+        }
+        return vehicles;
+    }
+    /**
+     * Sync GTFS static data for a city.
+     *
+     * Downloads the GTFS ZIP archive if newer than cached version,
+     * extracts routes and stops, and caches for future use.
+     *
+     * Throttled to minimum 60 seconds between calls for same city.
+     *
+     * @param city - City to sync
+     * @param force - Force re-download even if cache is current
+     * @returns Sync result with counts and status
+     * @throws {GtfsSyncError} If sync fails
+     *
+     * @example
+     * ```typescript
+     * const result = await transport.sync('vilnius');
+     * console.log(`Synced ${result.routeCount} routes`);
+     * ```
+     */
+    async sync(city, force = false) {
+        this.validateCity(city);
+        // Throttle sync calls (60s minimum between calls)
+        const lastSync = this.lastSyncTimes.get(city);
+        const now = Date.now();
+        if (!force && lastSync !== undefined && (now - lastSync) < 60000) {
+            // Return cached result
+            const cache = await loadGtfsCache(city, this.cacheDir);
+            if (cache) {
+                return {
+                    city,
+                    status: 'up-to-date',
+                    routeCount: cache.meta.routeCount,
+                    stopCount: cache.meta.stopCount,
+                    lastModified: cache.meta.lastModified,
+                    syncedAt: new Date(cache.meta.syncedAt),
+                };
+            }
+        }
+        const result = await syncGtfs(city, {
+            cacheDir: this.cacheDir,
+            timeout: this.requestTimeout * 3, // Longer timeout for downloads
+            userAgent: this.userAgent,
+            force,
+        });
+        this.lastSyncTimes.set(city, now);
+        // Clear in-memory cache to force reload
+        this.routeCaches.delete(city);
+        return result;
+    }
+    /**
+     * Get static stop data for a city.
+     *
+     * Requires prior `sync()` call to download GTFS data.
+     *
+     * @param city - City to get stops for
+     * @returns Array of stops
+     * @throws {SyncRequiredError} If GTFS data not synced
+     *
+     * @example
+     * ```typescript
+     * await transport.sync('vilnius');
+     * const stops = await transport.getStops('vilnius');
+     * console.log(`Found ${stops.length} stops`);
+     * ```
+     */
+    async getStops(city) {
+        this.validateCity(city);
+        const stops = await loadCachedStops(this.cacheDir, city);
+        if (!stops) {
+            throw new SyncRequiredError(city);
+        }
+        return stops;
+    }
+    /**
+     * Get route information for a city.
+     *
+     * Requires prior `sync()` call to download GTFS data.
+     *
+     * @param city - City to get routes for
+     * @returns Array of routes
+     * @throws {SyncRequiredError} If GTFS data not synced
+     *
+     * @example
+     * ```typescript
+     * await transport.sync('vilnius');
+     * const routes = await transport.getRoutes('vilnius');
+     * console.log(`Found ${routes.length} routes`);
+     * ```
+     */
+    async getRoutes(city) {
+        this.validateCity(city);
+        const routeCache = await this.getRouteCache(city);
+        if (!routeCache) {
+            throw new SyncRequiredError(city);
+        }
+        // Deduplicate (cache has entries by both short name and ID)
+        const seen = new Set();
+        const routes = [];
+        for (const route of routeCache.routes.values()) {
+            if (!seen.has(route.id)) {
+                seen.add(route.id);
+                routes.push(route);
+            }
+        }
+        return routes;
+    }
+    /**
+     * Get list of all supported city IDs.
+     */
+    getCities() {
+        return ALL_CITY_IDS;
+    }
+    /**
+     * Get configuration for a specific city.
+     */
+    getCityConfig(city) {
+        this.validateCity(city);
+        return getCityConfig(city);
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    /**
+     * Validate that city ID is valid.
+     */
+    validateCity(city) {
+        if (!(city in CITY_CONFIGS)) {
+            throw new InvalidCityError(city);
+        }
+    }
+    /**
+     * Fetch text content from URL.
+     */
+    async fetchText(url, city) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => { controller.abort(); }, this.requestTimeout);
+        try {
+            const response = await fetch(url, {
+                headers: { 'User-Agent': this.userAgent },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new TransportNetworkError(`HTTP ${String(response.status)}: ${response.statusText}`, city, response.status);
+            }
+            return await response.text();
+        }
+        catch (error) {
+            if (error instanceof TransportNetworkError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new TransportNetworkError(message, city, undefined, error instanceof Error ? error : undefined);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    /**
+     * Get route cache for a city, loading from disk if needed.
+     */
+    async getRouteCache(city) {
+        // Check in-memory cache first
+        const cached = this.routeCaches.get(city);
+        if (cached) {
+            return cached;
+        }
+        // Load from disk
+        const routes = await loadCachedRoutes(this.cacheDir, city);
+        if (routes) {
+            // Build RouteCache with normalized lookup map for O(1) case-insensitive matching
+            const cache = buildRouteCache(routes);
+            this.routeCaches.set(city, cache);
+            return cache;
+        }
+        return null;
+    }
+}
+export { GTFS_ROUTE_TYPE_MAP, LT_TRANSPORT_TYPE_MAP } from './types.js';
+// Config
+export { CITY_CONFIGS, ALL_CITY_IDS, getCityConfig, getCitiesByTier, hasGpsData, hasGtfsData } from './config.js';
+// Errors
+export { TransportError, TransportNetworkError, GpsNotAvailableError, SyncRequiredError, GtfsSyncError, ParseError, InvalidCityError, isTransportError, isNetworkError, } from './errors.js';
+// Utilities
+export { normalizeCoordinate, isValidLithuaniaCoord, LITHUANIA_BOUNDS, repairMojibake, secondsFromMidnightToDate, isDataStale, } from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parsers/gps-full.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GPS Full Format Parser with dynamic header-based column mapping
+ * @module parsers/gps-full
+ *
+ * Handles the "full" GPS format used by gold-tier cities (Vilnius, Kaunas, Klaipėda, Alytus, Druskininkai).
+ * Each city has different column layouts, so we parse headers dynamically.
+ *
+ * Column counts by city (empirically verified):
+ * - Vilnius: 18 columns
+ * - Kaunas: 14 columns
+ * - Klaipėda: 12 columns
+ * - Alytus: 13 columns
+ * - Druskininkai: 13 columns
+ */
+import type { CityId, Vehicle } from '../types.js';
+/**
+ * Options for GPS full format parsing.
+ */
+export interface GpsFullParseOptions {
+    /** Threshold in ms for marking data as stale (default: 5 minutes) */
+    staleThresholdMs?: number;
+    /** Whether to filter out stale records (default: false) */
+    filterStale?: boolean;
+    /** Whether to filter out records with invalid coordinates (default: true) */
+    filterInvalidCoords?: boolean;
+}
+/**
+ * Parse GPS full format stream from a gold-tier city.
+ *
+ * Uses header-based dynamic column mapping to handle different
+ * column layouts across cities.
+ *
+ * @param text - Raw text content from gps_full.txt
+ * @param city - City identifier for context
+ * @param options - Parse options
+ * @returns Array of normalized Vehicle objects
+ */
+export declare function parseGpsFullStream(text: string, city: CityId, options?: GpsFullParseOptions): Vehicle[];
+//# sourceMappingURL=gps-full.d.ts.map

package/dist/parsers/gps-full.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gps-full.d.ts","sourceRoot":"","sources":["../../src/parsers/gps-full.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AAsGhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,EAAE,CAyEX"}