@usa-open-data-connectors/usa-sources 0.1.7 → 0.1.9

package/dist/newJerseyOpenDataCatalogue.js

@@ -0,0 +1,48 @@
+import { buildSocrataCatalogueUrl, createSocrataCatalogueAdapter, fetchSocrataCatalogue, parseSocrataCataloguePayload, SOCRATA_CATALOGUE_LIMIT, } from './socrataCatalogue.js';
+/** Adapter id for the New Jersey Open Data catalogue source. */
+export const NEW_JERSEY_OPEN_DATA_CATALOGUE_SOURCE_ID = 'new-jersey-open-data-catalogue';
+/** Base URL for the New Jersey Open Data Socrata catalogue. */
+export const NEW_JERSEY_OPEN_DATA_API_BASE = 'https://data.nj.gov/api/views.json';
+/** How many catalogue entries one request reads. */
+export const NEW_JERSEY_OPEN_DATA_CATALOGUE_LIMIT = SOCRATA_CATALOGUE_LIMIT;
+/** Committed snapshot, so a build works when the New Jersey host is unreachable. */
+const NEW_JERSEY_OPEN_DATA_FIXTURE_FILENAME = 'new-jersey-open-data-catalogue-2026-11-08.json';
+/**
+ * Builds the request URL for one page of the New Jersey catalogue.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export function buildNewJerseyOpenDataCatalogueUrl(options) {
+    return buildSocrataCatalogueUrl(NEW_JERSEY_OPEN_DATA_API_BASE, options);
+}
+/**
+ * Parses one page of the New Jersey catalogue into entries and topic counts.
+ *
+ * @param payload - the JSON body from the New Jersey Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseNewJerseyOpenDataCataloguePayload(payload) {
+    return parseSocrataCataloguePayload(NEW_JERSEY_OPEN_DATA_CATALOGUE_SOURCE_ID, payload);
+}
+/**
+ * Reads one page of the New Jersey Open Data catalogue.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export async function fetchNewJerseyOpenDataCatalogue(options) {
+    return fetchSocrataCatalogue({
+        sourceId: NEW_JERSEY_OPEN_DATA_CATALOGUE_SOURCE_ID,
+        apiBase: NEW_JERSEY_OPEN_DATA_API_BASE,
+    }, options);
+}
+/** New Jersey Open Data catalogue of datasets, files, and stories, keyless. */
+export const newJerseyOpenDataCatalogueAdapter = createSocrataCatalogueAdapter({
+    sourceId: NEW_JERSEY_OPEN_DATA_CATALOGUE_SOURCE_ID,
+    name: 'New Jersey Open Data catalogue',
+    description: 'The New Jersey Open Data Socrata catalogue, one row per published dataset, file, story, or other resource, with its state topic, view count, and download count.',
+    apiBase: NEW_JERSEY_OPEN_DATA_API_BASE,
+    fixtureFilename: NEW_JERSEY_OPEN_DATA_FIXTURE_FILENAME,
+});
+//# sourceMappingURL=newJerseyOpenDataCatalogue.js.map

package/dist/newJerseyOpenDataCatalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newJerseyOpenDataCatalogue.js","sourceRoot":"","sources":["../src/newJerseyOpenDataCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GAIxB,MAAM,uBAAuB,CAAC;AAE/B,gEAAgE;AAChE,MAAM,CAAC,MAAM,wCAAwC,GAAG,gCAAgC,CAAC;AAEzF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,6BAA6B,GAAG,oCAAoC,CAAC;AAElF,oDAAoD;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,uBAAuB,CAAC;AAW5E,oFAAoF;AACpF,MAAM,qCAAqC,GAAG,gDAAgD,CAAC;AAE/F;;;;;GAKG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAA4B;IAC7E,OAAO,wBAAwB,CAAC,6BAA6B,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sCAAsC,CACpD,OAAgB;IAEhB,OAAO,4BAA4B,CAAC,wCAAwC,EAAE,OAAO,CAAC,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAGrD;IACC,OAAO,qBAAqB,CAC1B;QACE,QAAQ,EAAE,wCAAwC;QAClD,OAAO,EAAE,6BAA6B;KACvC,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC,GAAG,6BAA6B,CAAC;IAC7E,QAAQ,EAAE,wCAAwC;IAClD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,kKAAkK;IACpK,OAAO,EAAE,6BAA6B;IACtC,eAAe,EAAE,qCAAqC;CACvD,CAAC,CAAC"}

package/dist/nextBusTransitVehicles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nextBusTransitVehicles.d.ts","sourceRoot":"","sources":["../src/nextBusTransitVehicles.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,yDAAyD;AACzD,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,kDAAkD,CAAC;AAErF,iEAAiE;AACjE,eAAO,MAAM,qCAAqC,gBAAgB,CAAC;AAEnE,oDAAoD;AACpD,eAAO,MAAM,oCAAoC,QAAQ,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,gCAAgC;aAC3C,SAAS;aACT,QAAQ;CACA,CAAC;AAKX,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,uBAAuB,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAqDD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAQzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,mBAAsD,GAC5D,sBAAsB,CAyDxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAWlC;AAED,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,EAAE,aAAa,CAAC,sBAAsB,CAU/E,CAAC"}
+{"version":3,"file":"nextBusTransitVehicles.d.ts","sourceRoot":"","sources":["../src/nextBusTransitVehicles.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,yDAAyD;AACzD,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,kDAAkD,CAAC;AAErF,iEAAiE;AACjE,eAAO,MAAM,qCAAqC,gBAAgB,CAAC;AAEnE,oDAAoD;AACpD,eAAO,MAAM,oCAAoC,QAAQ,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,gCAAgC;aAC3C,SAAS;aACT,QAAQ;CACA,CAAC;AAKX,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,uBAAuB,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAqDD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAQzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,mBAAsD,GAC5D,sBAAsB,CAyDxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA+BlC;AAED,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,EAAE,aAAa,CAAC,sBAAsB,CAU/E,CAAC"}

package/dist/nextBusTransitVehicles.js

@@ -1,6 +1,6 @@
 import { XMLParser } from 'fast-xml-parser';
 import { z } from 'zod';
-import { UsSourceParseError } from './errors.js';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
 import { readFixtureText } from './fixtures.js';
 import { httpGet } from './http.js';
 /** Adapter id for the NextBus transit vehicle source. */
@@ -151,9 +151,20 @@ export function parseNextBusVehiclePayload(payload, query = NEXTBUS_PORTLAND_STR
  * @returns one report per vehicle, plus counts and report ages
  */
 export async function fetchNextBusVehicles(options) {
+    const agencyTag = options?.agencyTag;
+    const routeTag = options?.routeTag;
+    if ((agencyTag === undefined) !== (routeTag === undefined)) {
+        throw new UsSourceApiError(NEXTBUS_TRANSIT_VEHICLES_SOURCE_ID, 'Pass both agencyTag and routeTag, or neither.');
+    }
+    if (agencyTag?.trim().length === 0) {
+        throw new UsSourceApiError(NEXTBUS_TRANSIT_VEHICLES_SOURCE_ID, 'agencyTag must not be empty or whitespace.');
+    }
+    if (routeTag?.trim().length === 0) {
+        throw new UsSourceApiError(NEXTBUS_TRANSIT_VEHICLES_SOURCE_ID, 'routeTag must not be empty or whitespace.');
+    }
     const query = {
-        agencyTag: options?.agencyTag ?? NEXTBUS_PORTLAND_STREETCAR_AGENCY_TAG,
-        routeTag: options?.routeTag ?? NEXTBUS_PORTLAND_STREETCAR_ROUTE_TAG,
+        agencyTag: agencyTag?.trim() ?? NEXTBUS_PORTLAND_STREETCAR_AGENCY_TAG,
+        routeTag: routeTag?.trim() ?? NEXTBUS_PORTLAND_STREETCAR_ROUTE_TAG,
     };
     const response = await httpGet(NEXTBUS_TRANSIT_VEHICLES_SOURCE_ID, buildNextBusVehicleUrl(query), options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl });
     return parseNextBusVehiclePayload(await response.text(), query);

package/dist/nextBusTransitVehicles.js.map

@@ -1 +1 @@
-{"version":3,"file":"nextBusTransitVehicles.js","sourceRoot":"","sources":["../src/nextBusTransitVehicles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,yDAAyD;AACzD,MAAM,CAAC,MAAM,kCAAkC,GAAG,0BAA0B,CAAC;AAE7E,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,+CAA+C,CAAC;AAErF,iEAAiE;AACjE,MAAM,CAAC,MAAM,qCAAqC,GAAG,aAAa,CAAC;AAEnE,oDAAoD;AACpD,MAAM,CAAC,MAAM,oCAAoC,GAAG,KAAK,CAAC;AAE1D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,SAAS,EAAE,qCAAqC;IAChD,QAAQ,EAAE,oCAAoC;CACtC,CAAC;AAEX,iFAAiF;AACjF,MAAM,gCAAgC,GAAG,oDAAoD,CAAC;AAsD9F,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACvC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACzC,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtD,WAAW,EAAE,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;SAC/C,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACzC,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KACvF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,uFAAuF;AACvF,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,+BAA+B,CAAC;AAC5E,CAAC;AAED,iFAAiF;AACjF,SAAS,UAAU,CAAC,MAAgB;IAClC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA0B;IAC/D,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,OAAO,EAAE,kBAAkB;QAC3B,CAAC,EAAE,KAAK,CAAC,SAAS;QAClB,CAAC,EAAE,KAAK,CAAC,QAAQ;QACjB,CAAC,EAAE,GAAG;KACP,CAAC,CAAC;IACH,OAAO,GAAG,qBAAqB,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAgB,EAChB,KAAK,GAAwB,gCAAgC;IAE7D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,SAAS,CAAC;YACrB,gBAAgB,EAAE,KAAK;YACvB,mBAAmB,EAAE,EAAE;YACvB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,kCAAkC,EAClC,gCAAgC,EAChC,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,kBAAkB,CAAC,kCAAkC,EAAE,YAAY,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,kBAAkB,CAAC,kCAAkC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC3C,MAAM,QAAQ,GAAqB,CACjC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAC1F,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAClC,QAAQ,EAAE,OAAO,CAAC,GAAG;QACrB,SAAS,EAAE,OAAO,CAAC,GAAG;QACtB,cAAc,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QACvC,cAAc,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACzC,kBAAkB,EAAE,OAAO,CAAC,eAAe;QAC3C,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,QAAQ;SACpB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;SACxC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAEtD,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI;QAC/C,QAAQ;QACR,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,MAAM;QACjF,qBAAqB,EAAE,UAAU,CAAC,MAAM,CAAC;QACzC,mBAAmB,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC7E,mBAAmB,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAI1C;IACC,MAAM,KAAK,GAAwB;QACjC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,qCAAqC;QACtE,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,oCAAoC;KACpE,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,kCAAkC,EAClC,sBAAsB,CAAC,KAAK,CAAC,EAC7B,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACzE,CAAC;IACF,OAAO,0BAA0B,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,6BAA6B,GAA0C;IAClF,EAAE,EAAE,kCAAkC;IACtC,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,0KAA0K;IAC5K,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAC3B,oBAAoB,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;IAChG,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,0BAA0B,CAAC,OAAO,CAAC;IACvD,WAAW,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,eAAe,CAAC,gCAAgC,CAAC,CAAC;CACjG,CAAC"}
+{"version":3,"file":"nextBusTransitVehicles.js","sourceRoot":"","sources":["../src/nextBusTransitVehicles.ts"],"names":[],"mappings":"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"}

package/dist/nhtsaVehicleModels.d.ts

@@ -0,0 +1,74 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the NHTSA vehicle models source. */
+export declare const NHTSA_VEHICLE_MODELS_SOURCE_ID = "nhtsa-vehicle-models";
+/** Base URL for the NHTSA vehicle models API. */
+export declare const NHTSA_VEHICLE_MODELS_API_BASE = "https://api.nhtsa.gov/vehicles/models";
+/** Model year the default request reads. */
+export declare const NHTSA_DEFAULT_MODEL_YEAR = 2025;
+/** Make the default request reads. */
+export declare const NHTSA_DEFAULT_MAKE = "Honda";
+/** Largest page one request asks for. */
+export declare const NHTSA_MODEL_PAGE_SIZE = 100;
+/** Earliest model year the adapter accepts. */
+export declare const NHTSA_MIN_MODEL_YEAR = 1900;
+/** Latest model year the adapter accepts. */
+export declare const NHTSA_MAX_MODEL_YEAR = 2100;
+/** One vehicle model NHTSA lists for a model year and make. */
+export interface NhtsaVehicleModel {
+    modelYear: number;
+    make: string;
+    vehicleModel: string;
+}
+/** One page of NHTSA vehicle models, with the service's pagination metadata. */
+export interface NhtsaVehicleModelPage {
+    models: NhtsaVehicleModel[];
+    modelCount: number;
+    /** How many models the service says the query matches. */
+    totalCount: number;
+    offset: number;
+    max: number;
+    nextUrl: string | null;
+}
+/** Caller-selected filters for one model list. */
+export interface NhtsaVehicleModelsQuery {
+    modelYear?: number;
+    make?: string;
+    max?: number;
+    offset?: number;
+}
+/**
+ * Builds the request URL for one page of vehicle models.
+ *
+ * The endpoint is keyless. The default query is the 2025 Honda model list,
+ * which is the page the committed fixture captured.
+ *
+ * @param query - an optional model year, make, page size, and offset
+ * @returns the full request URL
+ */
+export declare function buildNhtsaVehicleModelsUrl(query?: NhtsaVehicleModelsQuery): string;
+/**
+ * Parses one page of vehicle models.
+ *
+ * A response whose service status is not 200 is an API error even when the
+ * host answers HTTP 200. A model without its year, make, or name is a changed
+ * shape and stops the parse. An empty page is valid.
+ *
+ * @param payload - the JSON body from the NHTSA vehicle models API
+ * @returns the models on the page and the service's pagination metadata
+ */
+export declare function parseNhtsaVehicleModelsPayload(payload: unknown): NhtsaVehicleModelPage;
+/**
+ * Reads one page of NHTSA vehicle models.
+ *
+ * One keyless request returns the models for one model year and make, plus
+ * the service's total and next-page URL.
+ *
+ * @param query - an optional model year, make, page window, and fetch stub
+ * @returns the models on the page and the service's pagination metadata
+ */
+export declare function fetchNhtsaVehicleModels(query?: NhtsaVehicleModelsQuery & {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NhtsaVehicleModelPage>;
+/** NHTSA vehicle models for one model year and make, keyless. */
+export declare const nhtsaVehicleModelsAdapter: UsDataAdapter<NhtsaVehicleModelPage>;
+//# sourceMappingURL=nhtsaVehicleModels.d.ts.map

package/dist/nhtsaVehicleModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nhtsaVehicleModels.d.ts","sourceRoot":"","sources":["../src/nhtsaVehicleModels.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,0CAA0C,CAAC;AAErF,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,yCAAyC;AACzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6DD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,GAAE,uBAA4B,GAAG,MAAM,CAStF;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAqBtF;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,GAAE,uBAAuB,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GAC5E,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,iEAAiE;AACjE,eAAO,MAAM,yBAAyB,EAAE,aAAa,CAAC,qBAAqB,CAa1E,CAAC"}

package/dist/nhtsaVehicleModels.js

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpGet } from './http.js';
+/** Adapter id for the NHTSA vehicle models source. */
+export const NHTSA_VEHICLE_MODELS_SOURCE_ID = 'nhtsa-vehicle-models';
+/** Base URL for the NHTSA vehicle models API. */
+export const NHTSA_VEHICLE_MODELS_API_BASE = 'https://api.nhtsa.gov/vehicles/models';
+/** Model year the default request reads. */
+export const NHTSA_DEFAULT_MODEL_YEAR = 2025;
+/** Make the default request reads. */
+export const NHTSA_DEFAULT_MAKE = 'Honda';
+/** Largest page one request asks for. */
+export const NHTSA_MODEL_PAGE_SIZE = 100;
+/** Earliest model year the adapter accepts. */
+export const NHTSA_MIN_MODEL_YEAR = 1900;
+/** Latest model year the adapter accepts. */
+export const NHTSA_MAX_MODEL_YEAR = 2100;
+/** Committed snapshot, so a build works when the NHTSA host is unreachable. */
+const NHTSA_VEHICLE_MODELS_FIXTURE_FILENAME = 'nhtsa-vehicle-models-2025-honda-2026-11-08.json';
+const NHTSA_MODEL_SCHEMA = z.object({
+    modelYear: z.number().int(),
+    make: z.string().min(1),
+    vehicleModel: z.string().min(1),
+});
+const NHTSA_PAGINATION_SCHEMA = z.object({
+    count: z.number().int().nonnegative(),
+    max: z.number().int().nonnegative(),
+    offset: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative(),
+    nextUrl: z.string().nullable().optional(),
+});
+const NHTSA_PAYLOAD_SCHEMA = z.object({
+    meta: z.object({
+        status: z.number().int(),
+        messages: z.array(z.unknown()).optional(),
+        pagination: NHTSA_PAGINATION_SCHEMA,
+    }),
+    results: z.array(NHTSA_MODEL_SCHEMA),
+});
+/** Throws when a model year or page value cannot be sent to the service. */
+function validateNhtsaQuery(query) {
+    const modelYear = query.modelYear ?? NHTSA_DEFAULT_MODEL_YEAR;
+    if (!Number.isInteger(modelYear) ||
+        modelYear < NHTSA_MIN_MODEL_YEAR ||
+        modelYear > NHTSA_MAX_MODEL_YEAR) {
+        throw new UsSourceApiError(NHTSA_VEHICLE_MODELS_SOURCE_ID, `modelYear must be a whole number from ${NHTSA_MIN_MODEL_YEAR} to ${NHTSA_MAX_MODEL_YEAR}.`);
+    }
+    const make = query.make ?? NHTSA_DEFAULT_MAKE;
+    if (make.trim() === '') {
+        throw new UsSourceApiError(NHTSA_VEHICLE_MODELS_SOURCE_ID, 'make must not be blank.');
+    }
+    const max = query.max ?? NHTSA_MODEL_PAGE_SIZE;
+    if (!Number.isInteger(max) || max < 1) {
+        throw new UsSourceApiError(NHTSA_VEHICLE_MODELS_SOURCE_ID, 'max must be a whole number of at least 1.');
+    }
+    const offset = query.offset ?? 0;
+    if (!Number.isInteger(offset) || offset < 0) {
+        throw new UsSourceApiError(NHTSA_VEHICLE_MODELS_SOURCE_ID, 'offset must be a whole number of at least 0.');
+    }
+}
+/**
+ * Builds the request URL for one page of vehicle models.
+ *
+ * The endpoint is keyless. The default query is the 2025 Honda model list,
+ * which is the page the committed fixture captured.
+ *
+ * @param query - an optional model year, make, page size, and offset
+ * @returns the full request URL
+ */
+export function buildNhtsaVehicleModelsUrl(query = {}) {
+    validateNhtsaQuery(query);
+    const params = new URLSearchParams({
+        modelYear: String(query.modelYear ?? NHTSA_DEFAULT_MODEL_YEAR),
+        make: (query.make ?? NHTSA_DEFAULT_MAKE).trim(),
+        max: String(query.max ?? NHTSA_MODEL_PAGE_SIZE),
+        offset: String(query.offset ?? 0),
+    });
+    return `${NHTSA_VEHICLE_MODELS_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses one page of vehicle models.
+ *
+ * A response whose service status is not 200 is an API error even when the
+ * host answers HTTP 200. A model without its year, make, or name is a changed
+ * shape and stops the parse. An empty page is valid.
+ *
+ * @param payload - the JSON body from the NHTSA vehicle models API
+ * @returns the models on the page and the service's pagination metadata
+ */
+export function parseNhtsaVehicleModelsPayload(payload) {
+    const parsed = NHTSA_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(NHTSA_VEHICLE_MODELS_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.meta.status !== 200) {
+        throw new UsSourceApiError(NHTSA_VEHICLE_MODELS_SOURCE_ID, `NHTSA reported status ${parsed.data.meta.status}`);
+    }
+    const pagination = parsed.data.meta.pagination;
+    return {
+        models: parsed.data.results,
+        modelCount: parsed.data.results.length,
+        totalCount: pagination.total,
+        offset: pagination.offset,
+        max: pagination.max,
+        nextUrl: pagination.nextUrl ?? null,
+    };
+}
+/**
+ * Reads one page of NHTSA vehicle models.
+ *
+ * One keyless request returns the models for one model year and make, plus
+ * the service's total and next-page URL.
+ *
+ * @param query - an optional model year, make, page window, and fetch stub
+ * @returns the models on the page and the service's pagination metadata
+ */
+export async function fetchNhtsaVehicleModels(query = {}) {
+    const fetchImpl = query.fetchImpl ?? globalThis.fetch;
+    const url = buildNhtsaVehicleModelsUrl({
+        ...(query.modelYear === undefined ? {} : { modelYear: query.modelYear }),
+        ...(query.make === undefined ? {} : { make: query.make }),
+        ...(query.max === undefined ? {} : { max: query.max }),
+        ...(query.offset === undefined ? {} : { offset: query.offset }),
+    });
+    const response = await httpGet(NHTSA_VEHICLE_MODELS_SOURCE_ID, url, { fetchImpl });
+    return parseNhtsaVehicleModelsPayload(await response.json());
+}
+/** NHTSA vehicle models for one model year and make, keyless. */
+export const nhtsaVehicleModelsAdapter = {
+    id: NHTSA_VEHICLE_MODELS_SOURCE_ID,
+    name: 'NHTSA vehicle models',
+    auth: 'none',
+    description: 'Vehicle models NHTSA lists for one model year and make, one row per model, with the service total and next-page URL.',
+    fetchLive: async (options) => fetchNhtsaVehicleModels(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseNhtsaVehicleModelsPayload(payload),
+    loadFixture: () => parseNhtsaVehicleModelsPayload(readFixtureJson(NHTSA_VEHICLE_MODELS_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=nhtsaVehicleModels.js.map

package/dist/nhtsaVehicleModels.js.map

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

package/dist/nihReporterProjects.d.ts

@@ -0,0 +1,98 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the NIH RePORTER funded-projects source. */
+export declare const NIH_REPORTER_SOURCE_ID = "nih-reporter-projects";
+/** Base URL for the NIH RePORTER v2 project search endpoint. */
+export declare const NIH_REPORTER_SEARCH_URL = "https://api.reporter.nih.gov/v2/projects/search";
+/** Fiscal year the committed fixture covers. */
+export declare const NIH_REPORTER_DEFAULT_FISCAL_YEAR = 2025;
+/** Number of projects one request asks for. */
+export declare const NIH_REPORTER_PAGE_SIZE = 10;
+/** One funded NIH project, trimmed to the fields a story reads. */
+export interface NihReporterProject {
+    /** The agency's project number, e.g. "5R01AI000001-01". */
+    projectNumber: string;
+    /** Core project number shared by awards under the same project, or null. */
+    coreProjectNumber: string | null;
+    projectTitle: string;
+    fiscalYear: number;
+    /** Award amount in US dollars for the fiscal year, or null when absent. */
+    awardAmount: number | null;
+    organizationName: string;
+    organizationCity: string | null;
+    organizationState: string | null;
+    /** Investigator names with repeated whitespace collapsed. */
+    principalInvestigators: string[];
+    /** NIH institute or centre that administers the project, or null. */
+    administeringInstitute: string | null;
+    /** Project start date as YYYY-MM-DD, or null when absent. */
+    projectStartDate: string | null;
+    /** Project end date as YYYY-MM-DD, or null when absent. */
+    projectEndDate: string | null;
+    /** Public RePORTER page for the project, or null when absent. */
+    projectDetailUrl: string | null;
+}
+/** One page of NIH RePORTER projects, with the agency's total match count. */
+export interface NihReporterProjectPage {
+    projects: NihReporterProject[];
+    projectCount: number;
+    totalCount: number;
+    offset: number;
+    limit: number;
+    /** Sum of the award amounts on this page, in US dollars. */
+    pageAwardAmountUsd: number;
+}
+/** Caller-selected filters for one project search. */
+export interface NihReporterProjectQuery {
+    fiscalYear?: number;
+    limit?: number;
+    offset?: number;
+}
+/** JSON body sent to the NIH RePORTER v2 project search endpoint. */
+export interface NihReporterSearchBody {
+    criteria: {
+        fiscal_years: number[];
+        agencies: string[];
+    };
+    include_fields: string[];
+    offset: number;
+    limit: number;
+    sort_field: string;
+    sort_order: 'asc' | 'desc';
+}
+/**
+ * Builds the JSON body for one project search.
+ *
+ * The endpoint is keyless. The default page is fiscal 2025, the year the
+ * fixture covers, ordered by the largest award first so repeated calls return
+ * a stable, useful slice of the file.
+ *
+ * @param query - an optional fiscal year, page size, and offset
+ * @returns the request body for the search endpoint
+ */
+export declare function buildNihReporterSearchBody(query?: NihReporterProjectQuery): NihReporterSearchBody;
+/**
+ * Parses one NIH RePORTER project search response.
+ *
+ * A body carrying a top-level message is an API error, even when the host
+ * answers HTTP 200. A project without its number, title, fiscal year, or
+ * organization is a changed shape and stops the parse.
+ *
+ * @param payload - the JSON body from the NIH RePORTER search endpoint
+ * @returns the projects on the page, the agency total, and the page award sum
+ */
+export declare function parseNihReporterProjectsPayload(payload: unknown): NihReporterProjectPage;
+/**
+ * Reads one page of NIH-funded projects through the RePORTER search API.
+ *
+ * One keyless POST returns a page of projects, the total number of matches,
+ * and the combined award value on that page.
+ *
+ * @param options - an optional fiscal year, page window, and fetch stub
+ * @returns the projects on the page and the search totals
+ */
+export declare function fetchNihReporterProjects(options?: NihReporterProjectQuery & {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NihReporterProjectPage>;
+/** NIH RePORTER funded projects, one row per project, keyless. */
+export declare const nihReporterProjectsAdapter: UsDataAdapter<NihReporterProjectPage>;
+//# sourceMappingURL=nihReporterProjects.d.ts.map

package/dist/nihReporterProjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nihReporterProjects.d.ts","sourceRoot":"","sources":["../src/nihReporterProjects.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,oDAAoD,CAAC;AAEzF,gDAAgD;AAChD,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,qEAAqE;IACrE,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,GAAE,uBAA4B,GAClC,qBAAqB,CAYvB;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAkDxF;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,uBAAuB,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GAC9E,OAAO,CAAC,sBAAsB,CAAC,CAYjC;AAED,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,sBAAsB,CAa5E,CAAC"}

package/dist/nihReporterProjects.js

@@ -0,0 +1,188 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpPostJson } from './http.js';
+/** Adapter id for the NIH RePORTER funded-projects source. */
+export const NIH_REPORTER_SOURCE_ID = 'nih-reporter-projects';
+/** Base URL for the NIH RePORTER v2 project search endpoint. */
+export const NIH_REPORTER_SEARCH_URL = 'https://api.reporter.nih.gov/v2/projects/search';
+/** Fiscal year the committed fixture covers. */
+export const NIH_REPORTER_DEFAULT_FISCAL_YEAR = 2025;
+/** Number of projects one request asks for. */
+export const NIH_REPORTER_PAGE_SIZE = 10;
+/** Committed snapshot, so a build works when the NIH host is unreachable. */
+const NIH_REPORTER_FIXTURE_FILENAME = 'nih-reporter-projects-fy2025-2026-11-07.json';
+/** Columns the adapter asks for. The full project record carries many more. */
+const NIH_REPORTER_INCLUDE_FIELDS = [
+    'ProjectNum',
+    'CoreProjectNum',
+    'ProjectTitle',
+    'FiscalYear',
+    'AwardAmount',
+    'Organization',
+    'PrincipalInvestigators',
+    'ProjectStartDate',
+    'ProjectEndDate',
+    'AgencyIcAdmin',
+    'ProjectDetailUrl',
+];
+const NIH_REPORTER_PROJECT_SCHEMA = z.object({
+    fiscal_year: z.number(),
+    project_num: z.string(),
+    core_project_num: z.string().nullable().optional(),
+    project_title: z.string(),
+    award_amount: z.number().nullable().optional(),
+    organization: z.object({
+        org_name: z.string(),
+        org_city: z.string().nullable().optional(),
+        org_state: z.string().nullable().optional(),
+    }),
+    principal_investigators: z
+        .array(z.object({ full_name: z.string().optional() }))
+        .nullable()
+        .optional(),
+    agency_ic_admin: z
+        .object({ abbreviation: z.string().optional(), name: z.string().optional() })
+        .nullable()
+        .optional(),
+    project_start_date: z.string().nullable().optional(),
+    project_end_date: z.string().nullable().optional(),
+    project_detail_url: z.string().nullable().optional(),
+});
+const NIH_REPORTER_PAYLOAD_SCHEMA = z.object({
+    meta: z
+        .object({
+        total: z.number(),
+        offset: z.number(),
+        limit: z.number(),
+    })
+        .optional(),
+    results: z.array(NIH_REPORTER_PROJECT_SCHEMA).optional(),
+    message: z.string().optional(),
+});
+/**
+ * Builds the JSON body for one project search.
+ *
+ * The endpoint is keyless. The default page is fiscal 2025, the year the
+ * fixture covers, ordered by the largest award first so repeated calls return
+ * a stable, useful slice of the file.
+ *
+ * @param query - an optional fiscal year, page size, and offset
+ * @returns the request body for the search endpoint
+ */
+export function buildNihReporterSearchBody(query = {}) {
+    return {
+        criteria: {
+            fiscal_years: [query.fiscalYear ?? NIH_REPORTER_DEFAULT_FISCAL_YEAR],
+            agencies: ['NIH'],
+        },
+        include_fields: NIH_REPORTER_INCLUDE_FIELDS,
+        offset: query.offset ?? 0,
+        limit: query.limit ?? NIH_REPORTER_PAGE_SIZE,
+        sort_field: 'award_amount',
+        sort_order: 'desc',
+    };
+}
+/** Converts an ISO timestamp or date to YYYY-MM-DD, or null when absent. */
+function normalizeNihReporterDate(value, field) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    const match = /^(\d{4}-\d{2}-\d{2})/.exec(value);
+    if (match === null) {
+        throw new UsSourceParseError(NIH_REPORTER_SOURCE_ID, `Unreadable ${field}: ${value}`);
+    }
+    return match[1] ?? null;
+}
+/** Collapses the repeated spaces NIH writes inside investigator names. */
+function normalizeInvestigatorName(name) {
+    return name.split(/\s+/).filter(Boolean).join(' ');
+}
+/**
+ * Parses one NIH RePORTER project search response.
+ *
+ * A body carrying a top-level message is an API error, even when the host
+ * answers HTTP 200. A project without its number, title, fiscal year, or
+ * organization is a changed shape and stops the parse.
+ *
+ * @param payload - the JSON body from the NIH RePORTER search endpoint
+ * @returns the projects on the page, the agency total, and the page award sum
+ */
+export function parseNihReporterProjectsPayload(payload) {
+    const parsed = NIH_REPORTER_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(NIH_REPORTER_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.message !== undefined) {
+        throw new UsSourceApiError(NIH_REPORTER_SOURCE_ID, parsed.data.message);
+    }
+    const meta = parsed.data.meta;
+    const rows = parsed.data.results;
+    if (meta === undefined || rows === undefined) {
+        throw new UsSourceParseError(NIH_REPORTER_SOURCE_ID, 'The response carried no meta block or results array');
+    }
+    const projects = rows.map((row) => ({
+        projectNumber: row.project_num,
+        coreProjectNumber: row.core_project_num ?? null,
+        projectTitle: row.project_title,
+        fiscalYear: row.fiscal_year,
+        awardAmount: row.award_amount ?? null,
+        organizationName: row.organization.org_name,
+        organizationCity: row.organization.org_city ?? null,
+        organizationState: row.organization.org_state ?? null,
+        principalInvestigators: (row.principal_investigators ?? []).flatMap((investigator) => {
+            if (investigator.full_name === undefined) {
+                return [];
+            }
+            const name = normalizeInvestigatorName(investigator.full_name);
+            return name === '' ? [] : [name];
+        }),
+        administeringInstitute: row.agency_ic_admin?.abbreviation === undefined || row.agency_ic_admin.abbreviation === ''
+            ? (row.agency_ic_admin?.name ?? null)
+            : row.agency_ic_admin.abbreviation,
+        projectStartDate: normalizeNihReporterDate(row.project_start_date, 'project start date'),
+        projectEndDate: normalizeNihReporterDate(row.project_end_date, 'project end date'),
+        projectDetailUrl: row.project_detail_url ?? null,
+    }));
+    return {
+        projects,
+        projectCount: projects.length,
+        totalCount: meta.total,
+        offset: meta.offset,
+        limit: meta.limit,
+        pageAwardAmountUsd: projects.reduce((total, project) => total + (project.awardAmount ?? 0), 0),
+    };
+}
+/**
+ * Reads one page of NIH-funded projects through the RePORTER search API.
+ *
+ * One keyless POST returns a page of projects, the total number of matches,
+ * and the combined award value on that page.
+ *
+ * @param options - an optional fiscal year, page window, and fetch stub
+ * @returns the projects on the page and the search totals
+ */
+export async function fetchNihReporterProjects(options = {}) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const body = buildNihReporterSearchBody({
+        ...(options.fiscalYear === undefined ? {} : { fiscalYear: options.fiscalYear }),
+        ...(options.limit === undefined ? {} : { limit: options.limit }),
+        ...(options.offset === undefined ? {} : { offset: options.offset }),
+    });
+    const response = await httpPostJson(NIH_REPORTER_SOURCE_ID, NIH_REPORTER_SEARCH_URL, body, {
+        fetchImpl,
+        headers: { accept: 'application/json' },
+    });
+    return parseNihReporterProjectsPayload(await response.json());
+}
+/** NIH RePORTER funded projects, one row per project, keyless. */
+export const nihReporterProjectsAdapter = {
+    id: NIH_REPORTER_SOURCE_ID,
+    name: 'NIH RePORTER funded projects',
+    auth: 'none',
+    description: 'NIH RePORTER funded projects for one fiscal year, with the project title, award amount, organization, principal investigators, and administering institute.',
+    fetchLive: async (options) => fetchNihReporterProjects(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseNihReporterProjectsPayload(payload),
+    loadFixture: () => parseNihReporterProjectsPayload(readFixtureJson(NIH_REPORTER_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=nihReporterProjects.js.map