gtfs 4.18.7 → 4.19.0

package/README.md

@@ -162,6 +162,7 @@ Copy `config-sample.json` to `config.json` and then add your projects configurat
 | [`gtfsRealtimeExpirationSeconds`](#gtfsrealtimeexpirationseconds) | integer           | Amount of time in seconds to allow GTFS-Realtime data to be stored in database before allowing to be deleted. Optional, defaults to 0.                              |
 | [`ignoreDuplicates`](#ignoreduplicates)                           | boolean           | Whether or not to ignore unique constraints on ids when importing GTFS, such as `trip_id`, `calendar_id`. Optional, defaults to false.                              |
 | [`ignoreErrors`](#ignoreerrors)                                   | boolean           | Whether or not to ignore errors during the import process. If true, failed files will be skipped while the rest are processed. Optional, defaults to false. |
+| [`includeImportReport`](#includeimportreport)                     | boolean           | Whether to return a report object from `importGtfs()` containing details about what was imported and any errors encountered. Optional, defaults to false. |
 | [`sqlitePath`](#sqlitepath)                                       | string            | A path to a SQLite database. Optional, defaults to using an in-memory database.                                                                                    |
 | [`verbose`](#verbose)                                             | boolean           | Whether or not to print output to the console. Optional, defaults to true.                                                                                          |
 
@@ -414,7 +415,7 @@ importGtfs({
       }
     }
   ],
-  "gtfsRealtimeExpirationSeconds": false
+  "gtfsRealtimeExpirationSeconds": 3600
 }
 ```
 
@@ -469,6 +470,22 @@ importGtfs({
 }
 ```
 
+### includeImportReport
+
+{Boolean} When `true`, `importGtfs()` returns an `ImportReport` object containing details about the import (record counts, errors encountered, etc.) instead of returning `void`. Useful when combined with `ignoreErrors: true` to inspect what failed after a partial import. Defaults to `false`.
+
+```js
+import { importGtfs } from 'gtfs';
+
+const report = await importGtfs({
+  agencies: [{ path: '/path/to/gtfs' }],
+  ignoreErrors: true,
+  includeImportReport: true,
+});
+
+console.log(report.errors);
+```
+
 ### sqlitePath
 
 {String} A path to a SQLite database. Optional, defaults to using an in-memory database with a value of `:memory:`.
@@ -684,7 +701,7 @@ closeDb(db);
 
 ### Deleting a Database
 
-You can use `deleteDb` to delete a sqlite3 database from the filesystem.
+You can use `deleteDb` to close and delete a database. For file-backed databases the file is removed from the filesystem. For in-memory databases (the default) the connection is closed and the internal reference is removed — no filesystem operation is performed.
 
 ```js
 import { deleteDb, openDb } from 'gtfs';
@@ -1050,7 +1067,7 @@ const trips = getTrips({
 const trips = getTrips({
   route_id: 'Lo-16APR',
   direction_id: 0,
-  service_id: '
+  service_id: 'CT-16APR-Caltrain-Weekday-01',
 });
 
 /*
@@ -1529,15 +1546,39 @@ In order to use GTFS-Realtime query methods, you must first run the [GTFS-Realti
 
 #### getServiceAlerts(query, fields, sortBy, options)
 
-Returns an array of GTFS Realtime service alerts that match query parameters. Note that this does not refresh the data from GTFS-Realtime feeds, it only fetches what is stored in the database. In order to fetch the latest service alerts from GTFS-Realtime feeds and store in your database, use the [GTFS-Realtime update script or function](#gtfsrealtime-update-script).
+Returns an array of GTFS Realtime service alerts that match query parameters. Each alert includes a nested `informed_entities` array containing all related informed entities (stops, routes, trips) that the alert applies to. Note that this does not refresh the data from GTFS-Realtime feeds, it only fetches what is stored in the database. In order to fetch the latest service alerts from GTFS-Realtime feeds and store in your database, use the [GTFS-Realtime update script or function](#gtfsrealtime-update-script).
 
 [More details on Service Alerts](https://gtfs.org/realtime/feed-entities/service-alerts/)
 
+Each alert has an `informed_entities` array containing all stops, routes, and trips the alert applies to. The `active_period` field is a JSON-serialised array of `{start, end}` Unix timestamp objects representing when the alert is active. The convenience fields `start_time` and `end_time` contain the start and end of the first active period (or `null` if none is set).
+
 ```js
 import { getServiceAlerts } from 'gtfs';
 
-// Get service alerts
+// Get all service alerts
 const serviceAlerts = getServiceAlerts();
+
+// Get alerts affecting a specific stop
+const stopAlerts = getServiceAlerts({ stop_id: 'STOP_ID' });
+
+// Get alerts affecting a specific route
+const routeAlerts = getServiceAlerts({ route_id: 'ROUTE_ID' });
+```
+
+#### getServiceAlertInformedEntities(query, fields, sortBy, options)
+
+Returns an array of GTFS Realtime service alert informed entities that match query parameters. Each row represents a single entity (stop, route, trip, etc.) that a service alert applies to, linked back to its alert via `alert_id`. Use this for direct access to the `service_alert_informed_entities` table; use `getServiceAlerts()` to get alerts with all informed entities already nested.
+
+[More details on Service Alert Informed Entities](https://gtfs.org/realtime/feed-entities/service-alerts/#entityselector)
+
+```js
+import { getServiceAlertInformedEntities } from 'gtfs';
+
+// Get all service alert informed entities
+const informedEntities = getServiceAlertInformedEntities();
+
+// Get all informed entities for a specific alert
+const informedEntities = getServiceAlertInformedEntities({ alert_id: 'some-alert-id' });
 ```
 
 #### getTripUpdates(query, fields, sortBy, options)
@@ -1714,6 +1755,22 @@ const riderships = getRidership({
 });
 ```
 
+#### getRiderCategories(query, fields, sortBy, options)
+
+Returns an array of rider categories that match query parameters. [Details on rider_categories.txt](http://gtfsride.org/specification#rider_categoriestxt)
+
+```js
+import { getRiderCategories } from 'gtfs';
+
+// Get all rider categories
+const riderCategories = getRiderCategories();
+
+// Get a specific rider category
+const riderCategories = getRiderCategories({
+  rider_category_id: '1',
+});
+```
+
 #### getTripCapacities(query, fields, sortBy, options)
 
 Returns an array of trip_capacity that match query parameters. [Details on trip_capacity.txt](http://gtfsride.org/specification#trip_capacitytxt)
@@ -1799,10 +1856,10 @@ Returns an array of run_events that match query parameters. [Details on run_even
 import { getRunEvents } from 'gtfs';
 
 // Get all run_events
-const runEvents = runEvents();
+const runEvents = getRunEvents();
 
-// Get a run_events for a specific piece
-const runEvents = runEvents({
+// Get run_events for a specific piece
+const runEvents = getRunEvents({
   piece_id: '123',
 });
 ```

package/dist/bin/gtfs-export.js

@@ -1114,6 +1114,7 @@ var routes = {
     {
       name: "agency_id",
       type: "text",
+      index: true,
       prefix: true
     },
     {
@@ -1366,7 +1367,8 @@ var stops = {
     },
     {
       name: "stop_code",
-      type: "text"
+      type: "text",
+      index: true
     },
     {
       name: "stop_name",
@@ -2868,16 +2870,14 @@ var serviceAlerts = {
     {
       name: "start_time",
       type: "text",
-      required: true,
       source: "alert.activePeriod[0].start",
-      default: ""
+      default: null
     },
     {
       name: "end_time",
       type: "text",
-      required: true,
       source: "alert.activePeriod[0].end",
-      default: ""
+      default: null
     },
     {
       name: "header_text",
@@ -2937,7 +2937,7 @@ var serviceAlertInformedEntities = {
     {
       name: "stop_id",
       type: "text",
-      index: true,
+      primary: true,
       source: "stopId",
       default: null,
       prefix: true
@@ -2945,7 +2945,7 @@ var serviceAlertInformedEntities = {
     {
       name: "route_id",
       type: "text",
-      index: true,
+      primary: true,
       source: "routeId",
       default: null,
       prefix: true
@@ -2953,14 +2953,14 @@ var serviceAlertInformedEntities = {
     {
       name: "route_type",
       type: "integer",
-      index: true,
+      primary: true,
       source: "routeType",
       default: null
     },
     {
       name: "trip_id",
       type: "text",
-      index: true,
+      primary: true,
       source: "trip.tripId",
       default: null,
       prefix: true
@@ -2968,7 +2968,7 @@ var serviceAlertInformedEntities = {
     {
       name: "direction_id",
       type: "integer",
-      index: true,
+      primary: true,
       source: "directionId",
       default: null
     },
@@ -3485,7 +3485,8 @@ var passengerEvents = {
     {
       name: "trip_stop_sequence",
       type: "integer",
-      min: 1
+      min: 1,
+      required: true
     },
     {
       name: "scheduled_stop_sequence",
@@ -3711,7 +3712,8 @@ var stopVisits = {
     },
     {
       name: "ramp_deployed_time",
-      type: "text"
+      type: "real",
+      min: 0
     },
     {
       name: "ramp_failure",
@@ -3719,12 +3721,12 @@ var stopVisits = {
     },
     {
       name: "kneel_deployed_time",
-      type: "integer",
+      type: "real",
       min: 0
     },
     {
       name: "lift_deployed_time",
-      type: "integer",
+      type: "real",
       min: 0
     },
     {