lt-public-transport-sdk 1.0.0

package/dist/scripts/test-live.js

@@ -0,0 +1,121 @@
+import { LtTransport } from '../index.js';
+import { ALL_CITY_IDS, CITY_CONFIGS } from '../config.js';
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+async function runLiveTest() {
+    console.log('🚀 Starting Live SDK Tests...\n');
+    const client = new LtTransport({
+        requestTimeout: 30000, // Longer timeout for live tests
+        filterStale: false, // We want to see stale data stats
+        autoEnrich: true,
+    });
+    const cityStats = {};
+    let totalErrors = 0;
+    for (const city of ALL_CITY_IDS) {
+        console.log(`\n---------------------------------------------------`);
+        console.log(`Testing City: ${city.toUpperCase()} (${CITY_CONFIGS[city].tier} tier)`);
+        console.log(`---------------------------------------------------`);
+        const stats = {
+            gps: { available: false, count: 0, stale: 0, invalidCoords: 0 },
+            gtfs: { routes: 0, stops: 0, synced: false },
+            enrichment: { matched: 0 }
+        };
+        try {
+            // 1. Test GPS Stream
+            console.log(`📡 Fetching live vehicles...`);
+            if (CITY_CONFIGS[city].gps.enabled) {
+                try {
+                    const vehicles = await client.getVehicles(city);
+                    stats.gps.available = true;
+                    stats.gps.count = vehicles.length;
+                    stats.gps.stale = vehicles.filter(v => v.isStale).length;
+                    stats.gps.invalidCoords = vehicles.filter(v => v.latitude === 0 || v.longitude === 0).length;
+                    console.log(`   ✅ Success: ${String(vehicles.length)} vehicles found`);
+                    console.log(`      - Stale: ${String(stats.gps.stale)}`);
+                    console.log(`      - enriching...`); // Will be checked after sync
+                    // Check sample vehicle
+                    if (vehicles.length > 0 && vehicles[0] !== undefined) {
+                        const sample = vehicles[0];
+                        console.log(`   🔍 Sample: [${sample.route}] ${sample.vehicleNumber} (${sample.type})`);
+                        console.log(`      Lat/Lon: ${sample.latitude.toFixed(4)}, ${sample.longitude.toFixed(4)}`);
+                        console.log(`      Measured: ${sample.measuredAt.toISOString()}`);
+                    }
+                }
+                catch (err) {
+                    console.error(`   ❌ GPS Error: ${getErrorMessage(err)}`);
+                    totalErrors++;
+                }
+            }
+            else {
+                console.log(`   ⚠️ GPS not enabled for this city.`);
+            }
+            // 2. Test GTFS Sync
+            console.log(`⬇️  Syncing GTFS data...`);
+            try {
+                const syncResult = await client.sync(city);
+                stats.gtfs.synced = true;
+                stats.gtfs.routes = syncResult.routeCount;
+                stats.gtfs.stops = syncResult.stopCount;
+                console.log(`   ✅ Synced: ${syncResult.status}`);
+                console.log(`      - Routes: ${String(syncResult.routeCount)}`);
+                console.log(`      - Stops: ${String(syncResult.stopCount)}`);
+            }
+            catch (err) {
+                console.error(`   ❌ GTFS Sync Error: ${getErrorMessage(err)}`);
+                totalErrors++;
+            }
+            // 3. Test GTFS Data Access
+            if (stats.gtfs.synced) {
+                try {
+                    const routes = await client.getRoutes(city);
+                    const stops = await client.getStops(city);
+                    console.log(`   ✅ Cache verified: ${String(routes.length)} routes, ${String(stops.length)} stops loaded.`);
+                }
+                catch (err) {
+                    console.error(`   ❌ GTFS Access Error: ${getErrorMessage(err)}`);
+                    totalErrors++;
+                }
+            }
+            // 4. Test Enrichment (Fetch vehicles again if GPS enabled)
+            if (CITY_CONFIGS[city].gps.enabled && stats.gtfs.synced) {
+                // Wait a bit to ensure async processing doesn't race? No, getVehicles should await enrichment.
+                const vehicles = await client.getVehicles(city);
+                const enriched = vehicles.filter(v => v.destination !== null);
+                stats.enrichment.matched = enriched.length;
+                console.log(`   ✨ Enrichment: ${String(enriched.length)}/${String(vehicles.length)} vehicles have destinations`);
+            }
+        }
+        catch (err) {
+            console.error(`❌ Critical City Error: ${getErrorMessage(err)}`);
+            totalErrors++;
+        }
+        cityStats[city] = stats;
+    }
+    console.log('\n===================================================');
+    console.log('TEST SUMMARY');
+    console.log('===================================================');
+    console.table(Object.entries(cityStats).map(([city, s]) => ({
+        City: city,
+        Vehicles: s.gps.count,
+        'Stale%': s.gps.count ? String(Math.round((s.gps.stale / s.gps.count) * 100)) + '%' : '-',
+        'Routes': s.gtfs.routes,
+        'Stops': s.gtfs.stops,
+        'Enriched': s.enrichment.matched
+    })));
+    if (totalErrors > 0) {
+        console.error(`\n❌ Completed with ${String(totalErrors)} errors.`);
+        process.exit(1);
+    }
+    else {
+        console.log(`\n✅ All tests passed successfully!`);
+    }
+}
+runLiveTest().catch((err) => {
+    console.error(getErrorMessage(err));
+    process.exit(1);
+});
+//# sourceMappingURL=test-live.js.map

package/dist/scripts/test-live.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Core type definitions for Lithuanian Public Transport SDK
+ * @module types
+ */
+import type { CityId } from './config.js';
+export type { CityId, CityTier } from './config.js';
+/**
+ * Vehicle types from Lithuanian public transport.
+ * - bus: Standard city buses (GTFS route_type 3)
+ * - trolleybus: Electric trolleybuses (GTFS route_type 800)
+ * - ferry: Water transport / boats (GTFS route_type 4 or 1200) - seasonal in Vilnius
+ * - unknown: Unrecognized vehicle type
+ */
+export type VehicleType = 'bus' | 'trolleybus' | 'ferry' | 'unknown';
+/**
+ * GTFS route_type to VehicleType mapping.
+ * Uses both standard and extended GTFS route types.
+ */
+export declare const GTFS_ROUTE_TYPE_MAP: Readonly<Record<number, VehicleType>>;
+/**
+ * Lithuanian transport type names to VehicleType mapping.
+ * Used when parsing GPS data streams.
+ */
+export declare const LT_TRANSPORT_TYPE_MAP: Readonly<Record<string, VehicleType>>;
+/**
+ * Normalized vehicle object representing a single public transport vehicle.
+ * This interface is consistent across all cities regardless of data source format.
+ */
+export interface Vehicle {
+    /** Unique identifier for this vehicle tracking record */
+    readonly id: string;
+    /** Vehicle number/code as displayed on the vehicle */
+    readonly vehicleNumber: string;
+    /** Route identifier (e.g., "4G", "N1", "S11") - always a string */
+    readonly route: string;
+    /** Type of vehicle */
+    readonly type: VehicleType;
+    /** Latitude in WGS84 decimal degrees */
+    readonly latitude: number;
+    /** Longitude in WGS84 decimal degrees */
+    readonly longitude: number;
+    /** Heading/bearing in degrees (0-359, 0 = North) */
+    readonly bearing: number;
+    /** Current speed in km/h */
+    readonly speed: number;
+    /** Destination/terminus name, if available */
+    readonly destination: string | null;
+    /** Delay in seconds (positive = late, negative = early), if available */
+    readonly delaySeconds: number | null;
+    /** Trip identifier from source system, if available */
+    readonly tripId: string | null;
+    /** GTFS trip reference, if available (Vilnius only) */
+    readonly gtfsTripId: string | null;
+    /** Next stop ID (Kaunas only) */
+    readonly nextStopId: string | null;
+    /** Predicted arrival time at next stop in seconds from midnight (Kaunas only) */
+    readonly arrivalTimeSeconds: number | null;
+    /**
+     * Whether this data is considered stale.
+     * True if measurement time is older than configured threshold.
+     */
+    readonly isStale: boolean;
+    /**
+     * Timestamp when the GPS position was measured.
+     * Falls back to server receive time if measurement time unavailable.
+     */
+    readonly measuredAt: Date;
+}
+/**
+ * Static stop/station data from GTFS.
+ */
+export interface Stop {
+    /** Unique stop identifier from GTFS */
+    readonly id: string;
+    /** Short code for the stop, if available */
+    readonly code: string | null;
+    /** Human-readable stop name */
+    readonly name: string;
+    /** Additional description, if available */
+    readonly description: string | null;
+    /** Latitude in WGS84 decimal degrees */
+    readonly latitude: number;
+    /** Longitude in WGS84 decimal degrees */
+    readonly longitude: number;
+}
+/**
+ * Route information from GTFS.
+ */
+export interface Route {
+    /** Unique route identifier from GTFS */
+    readonly id: string;
+    /** Short route name (e.g., "4G", "N1") */
+    readonly shortName: string;
+    /** Full route name with endpoints */
+    readonly longName: string;
+    /** Type of vehicles on this route */
+    readonly type: VehicleType;
+    /** Route color for display (hex without #) */
+    readonly color: string;
+    /** Text color for display on route color background (hex without #) */
+    readonly textColor: string;
+}
+/**
+ * Result of a GTFS sync operation.
+ */
+export interface SyncResult {
+    /** City that was synced */
+    readonly city: CityId;
+    /** Whether data was updated or already current */
+    readonly status: 'updated' | 'up-to-date';
+    /** Number of routes in cache after sync */
+    readonly routeCount: number;
+    /** Number of stops in cache after sync */
+    readonly stopCount: number;
+    /** Last-Modified timestamp from server */
+    readonly lastModified: string | null;
+    /** When this sync was performed */
+    readonly syncedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * Core type definitions for Lithuanian Public Transport SDK
+ * @module types
+ */
+/**
+ * GTFS route_type to VehicleType mapping.
+ * Uses both standard and extended GTFS route types.
+ */
+export const GTFS_ROUTE_TYPE_MAP = {
+    3: 'bus', // Standard GTFS: Bus
+    800: 'trolleybus', // Extended GTFS: Trolleybus
+    4: 'ferry', // Standard GTFS: Ferry
+    1200: 'ferry', // Extended GTFS: Ferry Service
+};
+/**
+ * Lithuanian transport type names to VehicleType mapping.
+ * Used when parsing GPS data streams.
+ */
+export const LT_TRANSPORT_TYPE_MAP = {
+    'Autobusai': 'bus',
+    'Troleibusai': 'trolleybus',
+    'Laivai': 'ferry',
+    'Keltai': 'ferry',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,CAAC,EAAE,KAAK,EAAU,qBAAqB;IACvC,GAAG,EAAE,YAAY,EAAE,4BAA4B;IAC/C,CAAC,EAAE,OAAO,EAAQ,uBAAuB;IACzC,IAAI,EAAE,OAAO,EAAK,+BAA+B;CACzC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA0C;IAC1E,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,YAAY;IAC3B,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,OAAO;CACT,CAAC"}

package/dist/utils/coordinates.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Coordinate normalization and validation utilities
+ * @module utils/coordinates
+ */
+/**
+ * Lithuania's geographic bounding box in WGS84 decimal degrees.
+ * Used to validate coordinates are within expected range.
+ */
+export declare const LITHUANIA_BOUNDS: {
+    /** Minimum latitude (southern border) */
+    readonly latMin: 53.89;
+    /** Maximum latitude (northern border) */
+    readonly latMax: 56.45;
+    /** Minimum longitude (western border) */
+    readonly lonMin: 20.93;
+    /** Maximum longitude (eastern border) */
+    readonly lonMax: 26.83;
+};
+/**
+ * Normalize a raw integer coordinate to WGS84 decimal degrees.
+ *
+ * @param raw - Raw coordinate as integer (e.g., 25255492 for ~25.255492°)
+ * @returns Normalized coordinate in decimal degrees
+ *
+ * @example
+ * normalizeCoordinate(25255492) // => 25.255492
+ * normalizeCoordinate(54633886) // => 54.633886
+ */
+export declare function normalizeCoordinate(raw: number): number;
+/**
+ * Check if coordinates fall within Lithuania's bounding box.
+ *
+ * @param lat - Latitude in WGS84 decimal degrees
+ * @param lon - Longitude in WGS84 decimal degrees
+ * @returns true if coordinates are within Lithuania
+ *
+ * @example
+ * isValidLithuaniaCoord(54.687, 25.279) // => true (Vilnius)
+ * isValidLithuaniaCoord(48.856, 2.352)  // => false (Paris)
+ */
+export declare function isValidLithuaniaCoord(lat: number, lon: number): boolean;
+/**
+ * Validate and normalize raw integer coordinates.
+ * Returns null if coordinates are invalid or outside Lithuania.
+ *
+ * @param rawLat - Raw latitude as integer
+ * @param rawLon - Raw longitude as integer
+ * @returns Object with normalized lat/lon, or null if invalid
+ */
+export declare function normalizeAndValidateCoordinates(rawLat: number, rawLon: number): {
+    latitude: number;
+    longitude: number;
+} | null;
+/**
+ * Normalize bearing to 0-359 range.
+ *
+ * @param bearing - Raw bearing value
+ * @returns Normalized bearing in degrees
+ */
+export declare function normalizeBearing(bearing: number): number;
+/**
+ * Normalize speed to non-negative value.
+ *
+ * @param speed - Raw speed value
+ * @returns Speed in km/h, minimum 0
+ */
+export declare function normalizeSpeed(speed: number): number;
+//# sourceMappingURL=coordinates.d.ts.map

package/dist/utils/coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../../src/utils/coordinates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,yCAAyC;;IAEzC,yCAAyC;;IAEzC,yCAAyC;;IAEzC,yCAAyC;;CAEjC,CAAC;AAQX;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAOvE;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAahD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/utils/coordinates.js

@@ -0,0 +1,98 @@
+/**
+ * Coordinate normalization and validation utilities
+ * @module utils/coordinates
+ */
+/**
+ * Lithuania's geographic bounding box in WGS84 decimal degrees.
+ * Used to validate coordinates are within expected range.
+ */
+export const LITHUANIA_BOUNDS = {
+    /** Minimum latitude (southern border) */
+    latMin: 53.89,
+    /** Maximum latitude (northern border) */
+    latMax: 56.45,
+    /** Minimum longitude (western border) */
+    lonMin: 20.93,
+    /** Maximum longitude (eastern border) */
+    lonMax: 26.83,
+};
+/**
+ * Coordinate divisor for stops.lt integer format.
+ * Raw coordinates are multiplied by 1,000,000 to avoid floating point.
+ */
+const COORDINATE_DIVISOR = 1_000_000;
+/**
+ * Normalize a raw integer coordinate to WGS84 decimal degrees.
+ *
+ * @param raw - Raw coordinate as integer (e.g., 25255492 for ~25.255492°)
+ * @returns Normalized coordinate in decimal degrees
+ *
+ * @example
+ * normalizeCoordinate(25255492) // => 25.255492
+ * normalizeCoordinate(54633886) // => 54.633886
+ */
+export function normalizeCoordinate(raw) {
+    return raw / COORDINATE_DIVISOR;
+}
+/**
+ * Check if coordinates fall within Lithuania's bounding box.
+ *
+ * @param lat - Latitude in WGS84 decimal degrees
+ * @param lon - Longitude in WGS84 decimal degrees
+ * @returns true if coordinates are within Lithuania
+ *
+ * @example
+ * isValidLithuaniaCoord(54.687, 25.279) // => true (Vilnius)
+ * isValidLithuaniaCoord(48.856, 2.352)  // => false (Paris)
+ */
+export function isValidLithuaniaCoord(lat, lon) {
+    return (lat >= LITHUANIA_BOUNDS.latMin &&
+        lat <= LITHUANIA_BOUNDS.latMax &&
+        lon >= LITHUANIA_BOUNDS.lonMin &&
+        lon <= LITHUANIA_BOUNDS.lonMax);
+}
+/**
+ * Validate and normalize raw integer coordinates.
+ * Returns null if coordinates are invalid or outside Lithuania.
+ *
+ * @param rawLat - Raw latitude as integer
+ * @param rawLon - Raw longitude as integer
+ * @returns Object with normalized lat/lon, or null if invalid
+ */
+export function normalizeAndValidateCoordinates(rawLat, rawLon) {
+    if (!Number.isFinite(rawLat) || !Number.isFinite(rawLon)) {
+        return null;
+    }
+    const latitude = normalizeCoordinate(rawLat);
+    const longitude = normalizeCoordinate(rawLon);
+    if (!isValidLithuaniaCoord(latitude, longitude)) {
+        return null;
+    }
+    return { latitude, longitude };
+}
+/**
+ * Normalize bearing to 0-359 range.
+ *
+ * @param bearing - Raw bearing value
+ * @returns Normalized bearing in degrees
+ */
+export function normalizeBearing(bearing) {
+    if (!Number.isFinite(bearing)) {
+        return 0;
+    }
+    // Handle negative values and wrap around
+    return ((bearing % 360) + 360) % 360;
+}
+/**
+ * Normalize speed to non-negative value.
+ *
+ * @param speed - Raw speed value
+ * @returns Speed in km/h, minimum 0
+ */
+export function normalizeSpeed(speed) {
+    if (!Number.isFinite(speed) || speed < 0) {
+        return 0;
+    }
+    return speed;
+}
+//# sourceMappingURL=coordinates.js.map

package/dist/utils/coordinates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.js","sourceRoot":"","sources":["../../src/utils/coordinates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,yCAAyC;IACzC,MAAM,EAAE,KAAK;IACb,yCAAyC;IACzC,MAAM,EAAE,KAAK;IACb,yCAAyC;IACzC,MAAM,EAAE,KAAK;IACb,yCAAyC;IACzC,MAAM,EAAE,KAAK;CACL,CAAC;AAEX;;;GAGG;AACH,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,GAAG,GAAG,kBAAkB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,GAAW;IAC5D,OAAO,CACL,GAAG,IAAI,gBAAgB,CAAC,MAAM;QAC9B,GAAG,IAAI,gBAAgB,CAAC,MAAM;QAC9B,GAAG,IAAI,gBAAgB,CAAC,MAAM;QAC9B,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAAc,EACd,MAAc;IAEd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE9C,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,yCAAyC;IACzC,OAAO,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/encoding.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Text encoding utilities for handling Windows-1257 and mojibake repair
+ * @module utils/encoding
+ */
+/**
+ * Attempt to repair mojibake (garbled text) caused by encoding mismatches.
+ * Common when Windows-1257 encoded text is read as UTF-8.
+ *
+ * @param text - Potentially corrupted text
+ * @returns Repaired text with Lithuanian characters restored
+ *
+ * @example
+ * repairMojibake('Autobusų parkas(EiÅ¡iÅ¡kių pl.)')
+ * // => 'Autobusų parkas(Eišiškių pl.)'
+ */
+export declare function repairMojibake(text: string): string;
+/**
+ * Check if text contains likely mojibake patterns.
+ *
+ * @param text - Text to check
+ * @returns true if mojibake patterns detected
+ */
+export declare function hasMojibake(text: string): boolean;
+/**
+ * Decode a byte array from Windows-1257 (Baltic) encoding to UTF-8 string.
+ *
+ * @param bytes - Raw bytes in Windows-1257 encoding
+ * @returns Decoded UTF-8 string
+ */
+export declare function decodeWindows1257(bytes: Uint8Array): string;
+/**
+ * Decode text from an ArrayBuffer, trying UTF-8 first, then falling back
+ * to Windows-1257 if mojibake is detected.
+ *
+ * @param buffer - Raw data buffer
+ * @returns Properly decoded string
+ */
+export declare function decodeBalticText(buffer: ArrayBuffer): string;
+/**
+ * Clean and normalize a text field from transport data.
+ * Handles encoding issues and trims whitespace.
+ *
+ * @param text - Raw text field
+ * @returns Cleaned text
+ */
+export declare function cleanTextField(text: string): string;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/utils/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/utils/encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAyBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAe3D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAoB5D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/dist/utils/encoding.js

@@ -0,0 +1,153 @@
+/**
+ * Text encoding utilities for handling Windows-1257 and mojibake repair
+ * @module utils/encoding
+ */
+/**
+ * Common mojibake patterns when Windows-1257 text is incorrectly decoded as UTF-8.
+ * Maps corrupted sequences to correct Lithuanian characters.
+ */
+const MOJIBAKE_REPAIRS = new Map([
+    // Lowercase Lithuanian letters
+    ['Ä…', 'ą'],
+    ['ć', 'ć'], // Not Lithuanian but may appear
+    ['Ä—', 'ė'],
+    ['Ä™', 'ę'], // Not Lithuanian but may appear
+    ['į', 'į'],
+    ['Å¡', 'š'],
+    ['ų', 'ų'],
+    ['Å«', 'ū'],
+    ['ž', 'ž'],
+    // Uppercase Lithuanian letters
+    ['Ä„', 'Ą'],
+    ['Ć', 'Ć'], // Not Lithuanian but may appear
+    ['Ä–', 'Ė'],
+    ['Ę', 'Ę'], // Not Lithuanian but may appear
+    ['Ä®', 'Į'],
+    ['Å ', 'Š'],
+    ['Ų', 'Ų'],
+    ['Ū', 'Ū'],
+    ['Ž', 'Ž'],
+    // Additional patterns that may occur
+    ['è', 'č'],
+    ['Ã ', 'ę'],
+    ['Å„', 'ń'],
+    ['Ä', 'č'], // Sometimes Ä alone appears for č
+]);
+/**
+ * Attempt to repair mojibake (garbled text) caused by encoding mismatches.
+ * Common when Windows-1257 encoded text is read as UTF-8.
+ *
+ * @param text - Potentially corrupted text
+ * @returns Repaired text with Lithuanian characters restored
+ *
+ * @example
+ * repairMojibake('Autobusų parkas(EiÅ¡iÅ¡kių pl.)')
+ * // => 'Autobusų parkas(Eišiškių pl.)'
+ */
+export function repairMojibake(text) {
+    let result = text;
+    for (const [corrupted, correct] of MOJIBAKE_REPAIRS) {
+        // Use global replace for all occurrences
+        result = result.split(corrupted).join(correct);
+    }
+    return result;
+}
+/**
+ * Check if text contains likely mojibake patterns.
+ *
+ * @param text - Text to check
+ * @returns true if mojibake patterns detected
+ */
+export function hasMojibake(text) {
+    for (const corrupted of MOJIBAKE_REPAIRS.keys()) {
+        if (text.includes(corrupted)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Windows-1257 (Baltic) code page byte-to-character mapping.
+ * Only maps bytes 128-255; 0-127 are identical to ASCII.
+ */
+const WINDOWS_1257_MAP = [
+    // 0x80-0x8F
+    '\u20AC', '', '\u201A', '', '\u201E', '\u2026', '\u2020', '\u2021', '', '\u2030', '', '\u2039', '', '\u00A8', '\u02C7', '\u00B8',
+    // 0x90-0x9F
+    '', '\u2018', '\u2019', '\u201C', '\u201D', '\u2022', '\u2013', '\u2014', '', '\u2122', '', '\u203A', '', '\u00AF', '\u02DB', '',
+    // 0xA0-0xAF
+    '\u00A0', '', '\u00A2', '\u00A3', '\u00A4', '', '\u00A6', '\u00A7', '\u00D8', '\u00A9', '\u0156', '\u00AB', '\u00AC', '\u00AD', '\u00AE', '\u00C6',
+    // 0xB0-0xBF
+    '\u00B0', '\u00B1', '\u00B2', '\u00B3', '\u00B4', '\u00B5', '\u00B6', '\u00B7', '\u00F8', '\u00B9', '\u0157', '\u00BB', '\u00BC', '\u00BD', '\u00BE', '\u00E6',
+    // 0xC0-0xCF
+    '\u0104', '\u012E', '\u0100', '\u0106', '\u00C4', '\u00C5', '\u0118', '\u0112', '\u010C', '\u00C9', '\u0179', '\u0116', '\u0122', '\u0136', '\u012A', '\u013B',
+    // 0xD0-0xDF
+    '\u0160', '\u0143', '\u0145', '\u00D3', '\u014C', '\u00D5', '\u00D6', '\u00D7', '\u0172', '\u0141', '\u015A', '\u016A', '\u00DC', '\u017B', '\u017D', '\u00DF',
+    // 0xE0-0xEF
+    '\u0105', '\u012F', '\u0101', '\u0107', '\u00E4', '\u00E5', '\u0119', '\u0113', '\u010D', '\u00E9', '\u017A', '\u0117', '\u0123', '\u0137', '\u012B', '\u013C',
+    // 0xF0-0xFF
+    '\u0161', '\u0144', '\u0146', '\u00F3', '\u014D', '\u00F5', '\u00F6', '\u00F7', '\u0173', '\u0142', '\u015B', '\u016B', '\u00FC', '\u017C', '\u017E', '\u02D9',
+];
+/**
+ * Decode a byte array from Windows-1257 (Baltic) encoding to UTF-8 string.
+ *
+ * @param bytes - Raw bytes in Windows-1257 encoding
+ * @returns Decoded UTF-8 string
+ */
+export function decodeWindows1257(bytes) {
+    const chars = [];
+    for (const byte of bytes) {
+        if (byte < 128) {
+            // ASCII range - direct mapping
+            chars.push(String.fromCharCode(byte));
+        }
+        else {
+            // Extended range - use Windows-1257 mapping
+            const mapped = WINDOWS_1257_MAP[byte - 128];
+            chars.push(mapped !== undefined && mapped !== '' ? mapped : '?');
+        }
+    }
+    return chars.join('');
+}
+/**
+ * Decode text from an ArrayBuffer, trying UTF-8 first, then falling back
+ * to Windows-1257 if mojibake is detected.
+ *
+ * @param buffer - Raw data buffer
+ * @returns Properly decoded string
+ */
+export function decodeBalticText(buffer) {
+    const bytes = new Uint8Array(buffer);
+    // First, try UTF-8 decoding
+    const decoder = new TextDecoder('utf-8', { fatal: false });
+    let text = decoder.decode(bytes);
+    // Check for mojibake patterns
+    if (hasMojibake(text)) {
+        // Try to repair the mojibake
+        text = repairMojibake(text);
+    }
+    // If still looks corrupted, try Windows-1257 directly
+    // (Check for remaining replacement characters or known patterns)
+    if (text.includes('\uFFFD') || /[\x80-\x9F]/.test(text)) {
+        text = decodeWindows1257(bytes);
+    }
+    return text;
+}
+/**
+ * Clean and normalize a text field from transport data.
+ * Handles encoding issues and trims whitespace.
+ *
+ * @param text - Raw text field
+ * @returns Cleaned text
+ */
+export function cleanTextField(text) {
+    if (!text)
+        return '';
+    // Repair any mojibake
+    let cleaned = repairMojibake(text.trim());
+    // Remove any control characters (ASCII 0-31 and 127)
+    // eslint-disable-next-line no-control-regex
+    cleaned = cleaned.replace(/[\x00-\x1F\x7F]/g, '');
+    return cleaned;
+}
+//# sourceMappingURL=encoding.js.map