@osmix/gtfs 0.0.1

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,48 @@
+/**
+ * GTFS (General Transit Feed Specification) type definitions.
+ *
+ * @module
+ */
+/**
+ * Map GTFS route_type to OSM route tag value.
+ */
+export function routeTypeToOsmRoute(routeType) {
+    switch (routeType) {
+        case "0":
+            return "tram";
+        case "1":
+            return "subway";
+        case "2":
+            return "train";
+        case "3":
+            return "bus";
+        case "4":
+            return "ferry";
+        case "5":
+            return "tram"; // Cable tram
+        case "6":
+            return "aerialway";
+        case "7":
+            return "funicular";
+        case "11":
+            return "trolleybus";
+        case "12":
+            return "train"; // Monorail
+        default:
+            return "bus";
+    }
+}
+/**
+ * Map GTFS wheelchair_boarding to OSM wheelchair tag value.
+ */
+export function wheelchairBoardingToOsm(value) {
+    switch (value) {
+        case "1":
+            return "yes";
+        case "2":
+            return "no";
+        default:
+            return undefined;
+    }
+}
+//# 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;;;;GAIG;AAuIH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACpD,QAAQ,SAAS,EAAE,CAAC;QACnB,KAAK,GAAG;YACP,OAAO,MAAM,CAAA;QACd,KAAK,GAAG;YACP,OAAO,QAAQ,CAAA;QAChB,KAAK,GAAG;YACP,OAAO,OAAO,CAAA;QACf,KAAK,GAAG;YACP,OAAO,KAAK,CAAA;QACb,KAAK,GAAG;YACP,OAAO,OAAO,CAAA;QACf,KAAK,GAAG;YACP,OAAO,MAAM,CAAA,CAAC,aAAa;QAC5B,KAAK,GAAG;YACP,OAAO,WAAW,CAAA;QACnB,KAAK,GAAG;YACP,OAAO,WAAW,CAAA;QACnB,KAAK,IAAI;YACR,OAAO,YAAY,CAAA;QACpB,KAAK,IAAI;YACR,OAAO,OAAO,CAAA,CAAC,WAAW;QAC3B;YACC,OAAO,KAAK,CAAA;IACd,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACtC,KAAyB;IAEzB,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,GAAG;YACP,OAAO,KAAK,CAAA;QACb,KAAK,GAAG;YACP,OAAO,IAAI,CAAA;QACZ;YACC,OAAO,SAAS,CAAA;IAClB,CAAC;AACF,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,25 @@
+import type { OsmTags } from "@osmix/shared/types";
+import { type GtfsRoute, type GtfsStop, type GtfsTrip } from "./types";
+/**
+ * Check if a ZIP file (as bytes) is a GTFS archive by looking for characteristic GTFS files.
+ * GTFS archives must contain at least agency.txt, stops.txt, routes.txt, trips.txt,
+ * and stop_times.txt according to the GTFS specification.
+ */
+export declare function isGtfsZip(bytes: Uint8Array): boolean;
+/**
+ * Convert a GTFS stop to OSM tags.
+ */
+export declare function stopToTags(stop: GtfsStop): OsmTags;
+/**
+ * Convert a GTFS route to OSM tags.
+ */
+export declare function routeToTags(route: GtfsRoute): OsmTags;
+/**
+ * Convert a GTFS trip to OSM tags.
+ */
+export declare function tripToTags(trip: GtfsTrip): OsmTags;
+/**
+ * Create a ReadableStream of text from file bytes.
+ */
+export declare function bytesToTextStream(bytes: Uint8Array): ReadableStream<string>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EACN,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EAGb,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAsFpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAoClD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAoCrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAelD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAqB3E"}

package/dist/utils.js

@@ -0,0 +1,211 @@
+import { routeTypeToOsmRoute, wheelchairBoardingToOsm, } from "./types";
+/**
+ * Check if a ZIP file (as bytes) is a GTFS archive by looking for characteristic GTFS files.
+ * GTFS archives must contain at least agency.txt, stops.txt, routes.txt, trips.txt,
+ * and stop_times.txt according to the GTFS specification.
+ */
+export function isGtfsZip(bytes) {
+    // GTFS required files per the spec
+    const requiredGtfsFiles = [
+        "agency.txt",
+        "stops.txt",
+        "routes.txt",
+        "trips.txt",
+        "stop_times.txt",
+    ];
+    // Find filenames in the ZIP by scanning for the local file headers
+    // ZIP local file header signature: 0x04034b50 (little-endian: 50 4b 03 04)
+    const foundFiles = new Set();
+    const decoder = new TextDecoder();
+    let pos = 0;
+    while (pos < bytes.length - 30) {
+        // Check for ZIP local file header signature
+        const isLocalHeader = bytes[pos] === 0x50 &&
+            bytes[pos + 1] === 0x4b &&
+            bytes[pos + 2] === 0x03 &&
+            bytes[pos + 3] === 0x04;
+        if (isLocalHeader) {
+            // Read filename length at offset 26-27 (little-endian)
+            const nameLen = (bytes[pos + 26] ?? 0) | ((bytes[pos + 27] ?? 0) << 8);
+            // Read extra field length at offset 28-29 (little-endian)
+            const extraLen = (bytes[pos + 28] ?? 0) | ((bytes[pos + 29] ?? 0) << 8);
+            // Defensive bounds check
+            if (nameLen < 0 || extraLen < 0)
+                break;
+            if (pos + 30 + nameLen + extraLen > bytes.length)
+                break;
+            // General purpose bit flag at offset 6-7 (little-endian)
+            // Bit 3 indicates the presence of a data descriptor, in which case
+            // the compressed size fields in the local header are zero and the
+            // actual sizes follow the compressed data.
+            const flags = (bytes[pos + 6] ?? 0) | ((bytes[pos + 7] ?? 0) << 8);
+            const hasDataDescriptor = (flags & 0x0008) !== 0;
+            // Extract filename (starts at offset 30)
+            const nameBytes = bytes.slice(pos + 30, pos + 30 + nameLen);
+            const filename = decoder.decode(nameBytes);
+            // Normalize path - extract just the filename part
+            const basename = filename.replace(/^.*\//, "").toLowerCase();
+            if (basename) {
+                foundFiles.add(basename);
+            }
+            if (!hasDataDescriptor) {
+                // Read compressed size at offset 18-21 (little-endian)
+                const compSize = (bytes[pos + 18] ?? 0) |
+                    ((bytes[pos + 19] ?? 0) << 8) |
+                    ((bytes[pos + 20] ?? 0) << 16) |
+                    ((bytes[pos + 21] ?? 0) << 24);
+                // Move to next entry using the known compressed size
+                pos += 30 + nameLen + extraLen + compSize;
+            }
+            else {
+                // When a data descriptor is present, the compressed size is not
+                // available in the local header. Skip past the header, filename,
+                // and extra fields, then scan forward for the next local header
+                // signature. This avoids getting stuck at the same position when
+                // the compressed size field is zero.
+                pos += 30 + nameLen + extraLen;
+                while (pos < bytes.length - 3) {
+                    const nextIsHeader = bytes[pos] === 0x50 &&
+                        bytes[pos + 1] === 0x4b &&
+                        bytes[pos + 2] === 0x03 &&
+                        bytes[pos + 3] === 0x04;
+                    if (nextIsHeader)
+                        break;
+                    pos++;
+                }
+            }
+        }
+        else {
+            pos++;
+        }
+    }
+    // Check if all required GTFS files are present
+    return requiredGtfsFiles.every((f) => foundFiles.has(f));
+}
+/**
+ * Convert a GTFS stop to OSM tags.
+ */
+export function stopToTags(stop) {
+    const tags = {
+        public_transport: "platform",
+    };
+    if (stop.stop_name)
+        tags["name"] = stop.stop_name;
+    if (stop.stop_id)
+        tags["ref"] = stop.stop_id;
+    if (stop.stop_code)
+        tags["ref:gtfs:stop_code"] = stop.stop_code;
+    if (stop.stop_desc)
+        tags["description"] = stop.stop_desc;
+    if (stop.stop_url)
+        tags["website"] = stop.stop_url;
+    if (stop.platform_code)
+        tags["ref:platform"] = stop.platform_code;
+    // Location type determines more specific tagging
+    const locationType = stop.location_type ?? "0";
+    switch (locationType) {
+        case "1":
+            tags["public_transport"] = "station";
+            break;
+        case "2":
+            // Entrances are not platforms - remove the default and use railway tag
+            delete tags["public_transport"];
+            tags["railway"] = "subway_entrance";
+            break;
+        case "3":
+            // Generic node - keep as platform
+            break;
+        case "4":
+            tags["public_transport"] = "platform";
+            break;
+    }
+    // Wheelchair accessibility
+    const wheelchair = wheelchairBoardingToOsm(stop.wheelchair_boarding);
+    if (wheelchair)
+        tags["wheelchair"] = wheelchair;
+    return tags;
+}
+/**
+ * Convert a GTFS route to OSM tags.
+ */
+export function routeToTags(route) {
+    const tags = {
+        route: routeTypeToOsmRoute(route.route_type),
+    };
+    // Use long name if available, otherwise short name
+    if (route.route_long_name) {
+        tags["name"] = route.route_long_name;
+    }
+    else if (route.route_short_name) {
+        tags["name"] = route.route_short_name;
+    }
+    if (route.route_short_name)
+        tags["ref"] = route.route_short_name;
+    if (route.route_id)
+        tags["ref:gtfs:route_id"] = route.route_id;
+    if (route.route_desc)
+        tags["description"] = route.route_desc;
+    if (route.route_url)
+        tags["website"] = route.route_url;
+    // Route color (normalize to include # prefix)
+    if (route.route_color) {
+        const color = route.route_color.startsWith("#")
+            ? route.route_color
+            : `#${route.route_color}`;
+        tags["color"] = color;
+    }
+    if (route.route_text_color) {
+        const textColor = route.route_text_color.startsWith("#")
+            ? route.route_text_color
+            : `#${route.route_text_color}`;
+        tags["text_color"] = textColor;
+    }
+    // Route type as additional tag
+    tags["gtfs:route_type"] = route.route_type;
+    return tags;
+}
+/**
+ * Convert a GTFS trip to OSM tags.
+ */
+export function tripToTags(trip) {
+    const tags = {};
+    tags["ref:gtfs:trip_id"] = trip.trip_id;
+    if (trip.service_id)
+        tags["ref:gtfs:service_id"] = trip.service_id;
+    if (trip.trip_headsign)
+        tags["ref:gtfs:trip_headsign"] = trip.trip_headsign;
+    if (trip.trip_short_name)
+        tags["ref:gtfs:trip_short_name"] = trip.trip_short_name;
+    if (trip.direction_id)
+        tags["ref:gtfs:direction_id"] = trip.direction_id;
+    if (trip.block_id)
+        tags["ref:gtfs:block_id"] = trip.block_id;
+    if (trip.shape_id)
+        tags["ref:gtfs:shape_id"] = trip.shape_id;
+    if (trip.wheelchair_accessible)
+        tags["ref:gtfs:wheelchair_accessible"] = trip.wheelchair_accessible;
+    if (trip.bikes_allowed)
+        tags["ref:gtfs:bikes_allowed"] = trip.bikes_allowed;
+    return tags;
+}
+/**
+ * Create a ReadableStream of text from file bytes.
+ */
+export function bytesToTextStream(bytes) {
+    const decoder = new TextDecoder();
+    let offset = 0;
+    const chunkSize = 64 * 1024; // 64KB chunks
+    return new ReadableStream({
+        pull(controller) {
+            if (offset >= bytes.length) {
+                controller.close();
+                return;
+            }
+            const end = Math.min(offset + chunkSize, bytes.length);
+            const chunk = bytes.subarray(offset, end);
+            offset = end;
+            controller.enqueue(decoder.decode(chunk, { stream: offset < bytes.length }));
+        },
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+	"$schema": "https://json.schemastore.org/package",
+	"name": "@osmix/gtfs",
+	"description": "Convert GTFS transit feeds to OSM format.",
+	"version": "0.0.1",
+	"type": "module",
+	"main": "./src/index.ts",
+	"types": "./src/index.ts",
+	"publishConfig": {
+		"access": "public",
+		"main": "./dist/index.js",
+		"types": "./dist/index.d.ts",
+		"exports": {
+			".": {
+				"import": "./dist/index.js",
+				"types": "./dist/index.d.ts"
+			}
+		},
+		"files": [
+			"dist",
+			"README.md",
+			"LICENSE"
+		]
+	},
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/conveyal/osmix.git"
+	},
+	"homepage": "https://github.com/conveyal/osmix#readme",
+	"bugs": {
+		"url": "https://github.com/conveyal/osmix/issues"
+	},
+	"sideEffects": false,
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"bench": "bun test --bench",
+		"prepublishOnly": "tsc",
+		"test": "bun test",
+		"typecheck": "tsgo --noEmit"
+	},
+	"devDependencies": {
+		"@types/bun": "catalog:",
+		"fflate": "^0.8.2",
+		"typescript": "catalog:"
+	},
+	"dependencies": {
+		"@osmix/core": "workspace:*",
+		"@osmix/shared": "workspace:*",
+		"@std/csv": "npm:@jsr/std__csv",
+		"but-unzip": "^0.1.7"
+	}
+}

package/src/from-gtfs.ts

@@ -0,0 +1,259 @@
+/**
+ * GTFS to OSM conversion utilities.
+ *
+ * Imports GTFS transit feeds into Osm indexes, mapping:
+ * - Stops → Nodes with transit tags
+ * - Routes → Ways with shape geometry
+ *
+ * Uses lazy, on-demand parsing - files are only parsed when needed.
+ *
+ * @module
+ */
+
+import { Osm, type OsmOptions } from "@osmix/core"
+import {
+	logProgress,
+	type ProgressEvent,
+	progressEvent,
+} from "@osmix/shared/progress"
+import type { OsmTags } from "@osmix/shared/types"
+import { GtfsArchive } from "./gtfs-archive"
+import type { GtfsConversionOptions, GtfsShapePoint } from "./types"
+import { routeToTags, stopToTags } from "./utils"
+
+/**
+ * Create an Osm index from a zipped GTFS file.
+ *
+ * Parses the GTFS zip lazily - only reading files when needed.
+ * Converts stops and routes to OSM entities:
+ * - Stops become nodes with transit-related tags
+ * - Routes become ways with shape geometry (if available) or stop sequence
+ *
+ * @param zipData - The GTFS zip file as ArrayBuffer or Uint8Array
+ * @param options - Osm index options (id, header)
+ * @param gtfsOptions - GTFS conversion options
+ * @param onProgress - Progress callback for UI feedback
+ * @returns Populated Osm index with built indexes
+ *
+ * @example
+ * ```ts
+ * import { fromGtfs } from "@osmix/gtfs"
+ *
+ * const response = await fetch("https://example.com/gtfs.zip")
+ * const zipData = await response.arrayBuffer()
+ * const osm = await fromGtfs(zipData, { id: "transit" })
+ *
+ * console.log(`Imported ${osm.nodes.size} stops`)
+ * ```
+ */
+export async function fromGtfs(
+	zipData: ArrayBuffer | Uint8Array,
+	options: Partial<OsmOptions> = {},
+	gtfsOptions: GtfsConversionOptions = {},
+	onProgress: (progress: ProgressEvent) => void = logProgress,
+): Promise<Osm> {
+	onProgress(progressEvent("Opening GTFS archive..."))
+	const archive = GtfsArchive.fromZip(zipData)
+	const builder = new GtfsOsmBuilder(options, onProgress)
+	if (gtfsOptions.includeStops ?? true) {
+		await builder.processStops(archive)
+	}
+
+	if (gtfsOptions.includeRoutes ?? true) {
+		await builder.processRoutes(archive)
+	}
+
+	return builder.buildOsm()
+}
+
+/**
+ * Builder class for converting GTFS data to OSM entities.
+ *
+ * Uses lazy parsing - only reads GTFS files when needed.
+ */
+export class GtfsOsmBuilder {
+	private osm: Osm
+	private onProgress: (progress: ProgressEvent) => void
+
+	private nextNodeId = -1
+	private nextWayId = -1
+
+	// Map GTFS stop_id to OSM node ID
+	private stopIdToNodeId = new Map<string, number>()
+
+	constructor(
+		osmOptions: Partial<OsmOptions> = {},
+		onProgress: (progress: ProgressEvent) => void = logProgress,
+	) {
+		this.osm = new Osm(osmOptions)
+		this.onProgress = onProgress
+	}
+
+	/**
+	 * Process GTFS stops into OSM nodes.
+	 * Uses streaming iteration to avoid loading all stops at once.
+	 */
+	async processStops(archive: GtfsArchive) {
+		let count = 0
+
+		this.onProgress(progressEvent("Processing stops..."))
+
+		for await (const stop of archive.iter("stops.txt")) {
+			const lat = Number.parseFloat(stop.stop_lat)
+			const lon = Number.parseFloat(stop.stop_lon)
+
+			if (Number.isNaN(lat) || Number.isNaN(lon)) continue
+
+			const tags = stopToTags(stop)
+			const nodeId = this.nextNodeId--
+
+			this.osm.nodes.addNode({
+				id: nodeId,
+				lat,
+				lon,
+				tags,
+			})
+
+			this.stopIdToNodeId.set(stop.stop_id, nodeId)
+			count++
+
+			if (count % 1000 === 0) {
+				this.onProgress(progressEvent(`Processed ${count} stops...`))
+			}
+		}
+
+		this.onProgress(progressEvent(`Added ${count} stops as nodes`))
+	}
+
+	/**
+	 * Process GTFS routes into OSM ways.
+	 * Creates one way per unique (shape_id, route_id) pair, so each route gets
+	 * its own way with correct metadata even when routes share the same shape.
+	 *
+	 * @param archive - The GTFS archive
+	 */
+	async processRoutes(archive: GtfsArchive) {
+		this.onProgress(progressEvent("Processing routes..."))
+
+		// Build shape lookup if shapes exist
+		const shapeMap = new Map<string, GtfsShapePoint[]>()
+		if (archive.hasFile("shapes.txt")) {
+			this.onProgress(progressEvent("Loading shape data..."))
+			for await (const point of archive.iter("shapes.txt")) {
+				const points = shapeMap.get(point.shape_id) ?? []
+				points.push(point)
+				shapeMap.set(point.shape_id, points)
+			}
+			// Sort each shape by sequence
+			for (const points of shapeMap.values()) {
+				points.sort(
+					(a, b) =>
+						Number.parseInt(a.shape_pt_sequence, 10) -
+						Number.parseInt(b.shape_pt_sequence, 10),
+				)
+			}
+		} else {
+			throw Error("No shape data found. Cannot process routes.")
+		}
+
+		// Group trips by (shape_id, route_id) to ensure each route gets its own way
+		// even when multiple routes share the same shape geometry
+		const shapeRouteToTrips = new Map<string, { tripIds: string[] }>()
+		this.onProgress(progressEvent("Loading trip data..."))
+		for await (const trip of archive.iter("trips.txt")) {
+			if (!trip.shape_id) continue
+
+			const key = `${trip.shape_id}:${trip.route_id}`
+			const existing = shapeRouteToTrips.get(key)
+			if (existing) {
+				existing.tripIds.push(trip.trip_id)
+			} else {
+				shapeRouteToTrips.set(key, { tripIds: [trip.trip_id] })
+			}
+		}
+
+		// Load routes into a map for lookup
+		const routeMap = new Map<string, Awaited<ReturnType<typeof routeToTags>>>()
+		for await (const route of archive.iter("routes.txt")) {
+			routeMap.set(route.route_id, routeToTags(route))
+		}
+
+		// Process unique (shape, route) pairs - one way per combination
+		let count = 0
+		for (const [key, { tripIds }] of shapeRouteToTrips) {
+			const [shapeId, routeId] = key.split(":")
+			const routeTags = routeMap.get(routeId!)
+			if (!routeTags) continue
+
+			const shapePoints = shapeMap.get(shapeId!)
+			if (!shapePoints || shapePoints.length < 2) {
+				this.onProgress(
+					progressEvent(`No shape data found for shape ${shapeId}`, "error"),
+				)
+				continue
+			}
+
+			// Build tags with route info and all trip IDs for this route
+			const tags: OsmTags = {
+				...routeTags,
+				"gtfs:shape_id": shapeId!,
+				"gtfs:trip_ids": tripIds.join(";"),
+				"gtfs:trip_count": tripIds.length,
+			}
+
+			// Create way from shape points
+			this.createWayFromShape(tags, shapePoints)
+			count++
+
+			if (count % 100 === 0) {
+				this.onProgress(
+					progressEvent(`Processed ${count} shape-route pairs...`),
+				)
+			}
+		}
+
+		this.onProgress(progressEvent(`Added ${count} shape-route pairs as ways`))
+	}
+
+	/**
+	 * Create a way from shape points.
+	 */
+	private createWayFromShape(tags: OsmTags, shapePoints: GtfsShapePoint[]) {
+		const nodeRefs: number[] = []
+
+		for (const point of shapePoints) {
+			const lat = Number.parseFloat(point.shape_pt_lat)
+			const lon = Number.parseFloat(point.shape_pt_lon)
+
+			if (Number.isNaN(lat) || Number.isNaN(lon)) continue
+
+			// Create a node for this shape point
+			const nodeId = this.nextNodeId--
+			this.osm.nodes.addNode({
+				id: nodeId,
+				lat,
+				lon,
+			})
+			nodeRefs.push(nodeId)
+		}
+
+		if (nodeRefs.length >= 2) {
+			const wayId = this.nextWayId--
+			this.osm.ways.addWay({
+				id: wayId,
+				refs: nodeRefs,
+				tags,
+			})
+		}
+	}
+
+	/**
+	 * Build the OSM index with all entities.
+	 */
+	buildOsm(): Osm {
+		this.onProgress(progressEvent("Building indexes..."))
+		this.osm.buildIndexes()
+		this.osm.buildSpatialIndexes()
+		return this.osm
+	}
+}