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

package/README.md

@@ -4,7 +4,7 @@ Uniform TypeScript adapters for US public data sources, with live probes and off
 
 ## What this package does
 
-- Exposes 24 source adapters behind one interface.
+- Exposes 26 source adapters behind one interface.
 - Fetches live data from each source and parses it into plain objects.
 - Loads a committed fixture when the network is unavailable.
 - Publishes the `US_DATA_SOURCES` registry for the API and the CLI.
@@ -53,6 +53,9 @@ console.log(probes.map((probe) => `${probe.id}: ${probe.ok ? 'ok' : probe.status
 | `bts-transportation-stats` | Bureau of Transportation Statistics | The BTS Socrata catalogue, one row per dataset, chart, or story. |
 | `estimatetax-income-tax` | EstimateTax | US federal, state, and local income tax for one salary, with the official document behind every figure. |
 | `nyc-open-data-catalogue` | New York City Open Data | The NYC Socrata catalogue, one row per published dataset or map. |
+| `callook-callsigns` | Callook.info | US amateur radio callsign records from the FCC licence file, with the licence class, location, and expiry. |
+| `college-scorecard-institutions` | College Scorecard, US Department of Education | Institution-level enrollment, cost, completion, debt, and earnings ten years after entry for US colleges. |
+| `nextbus-transit-vehicles` | Portland Streetcar, through the NextBus XML feed | Live positions, headings, speeds, and report ages for the streetcars on the NS line. |
 
 The HTTP API and the CLI read this package's registry. A new adapter is exposed on
 `/api/sources`, `/api/sources/{id}/probe`, and `/api/sources/{id}/data` as soon as it is registered.
@@ -277,6 +280,53 @@ validates a bare JSON array against a zod schema over `id`, `name`,
 throws `UsSourceParseError`. A response with no rows also throws, because an
 empty catalogue is not a usable answer.
 
+`bts-transportation-stats`:
+
+```ts
+import {
+  buildBtsTransportationStatsUrl,
+  parseBtsTransportationStatsPayload,
+} from '@usa-open-data-connectors/usa-sources';
+
+const url = buildBtsTransportationStatsUrl({ limit: 10_000 });
+const response = await fetch(url);
+if (!response.ok) {
+  throw new Error(`HTTP ${response.status} from ${url}`);
+}
+const catalogue = parseBtsTransportationStatsPayload(await response.json());
+console.log(catalogue.entryCount, catalogue.datasetCount, catalogue.categories[0]);
+```
+
+The public API is `BTS_TRANSPORTATION_STATS_API_BASE`,
+`BTS_TRANSPORTATION_STATS_LIMIT`, `buildBtsTransportationStatsUrl`,
+`parseBtsTransportationStatsPayload`, `fetchBtsTransportationStats`, and
+`btsTransportationStatsAdapter`, with the `BtsCatalogueEntry`,
+`BtsCatalogueCategoryCount`, and `BtsTransportationCatalogue` types. The parser
+validates a bare JSON array against a zod schema over `id`, `name`,
+`assetType`, `category`, `viewType`, `createdAt`, `viewLastModified`,
+`viewCount`, and `downloadCount`. A row missing `id`, `name`, or `createdAt`
+throws `UsSourceParseError`. A response with no rows also throws, because an
+empty catalogue is not a usable answer.
+
+`nextbus-transit-vehicles`:
+
+```ts
+import { fetchNextBusVehicles } from '@usa-open-data-connectors/usa-sources';
+
+const snapshot = await fetchNextBusVehicles();
+console.log(snapshot.vehicleCount, snapshot.vehicles[0]);
+```
+
+The public API is `NEXTBUS_XML_FEED_BASE`, `NEXTBUS_PORTLAND_STREETCAR_AGENCY_TAG`,
+`NEXTBUS_PORTLAND_STREETCAR_ROUTE_TAG`, `NEXTBUS_PORTLAND_STREETCAR_QUERY`,
+`buildNextBusVehicleUrl`, `parseNextBusVehiclePayload`, `fetchNextBusVehicles`,
+and `nextBusTransitVehiclesAdapter`, with the `NextBusVehicle`,
+`NextBusVehicleQuery`, and `NextBusVehicleSnapshot` types. The parser reads
+the XML attributes as strings and validates every field with zod. An error
+body, a missing timestamp, or a position outside the map throws
+`UsSourceParseError`. A route with no vehicles is valid and returns an empty
+`vehicles` list.
+
 `fema-disaster-declarations`:
 
 ```ts
@@ -425,6 +475,65 @@ COVID", because keywords and related terms also match. The response has no
 total count unless the request adds `countTotal=true`, so count `studies` for
 the page or ask for the total separately.
 
+`nws-point-forecast`:
+
+```ts
+import { fetchNwsPointForecast } from '@usa-open-data-connectors/usa-sources';
+
+const point = await fetchNwsPointForecast({ latitude: 47.601, longitude: -122.33 });
+console.log(point.gridId, point.gridX, point.gridY, point.forecastUrl);
+```
+
+The public API is `NWS_API_BASE`, `NWS_POINT_FORECAST_PATH`,
+`NWS_POINT_FORECAST_SOURCE_ID`, `NWS_USER_AGENT`, `NWS_DEFAULT_LATITUDE`,
+`NWS_DEFAULT_LONGITUDE`, `buildNwsPointUrl`, `parseNwsPointForecastPayload`,
+`fetchNwsPointForecast`, and `nwsPointForecastAdapter`, with the
+`NwsForecastPoint` type. The parser validates the response with a zod schema
+over `type`, `geometry.coordinates`, and a `properties` object carrying
+`city`, `state`, `gridId`, `gridX`, `gridY`, `forecastOffice`, `forecast`,
+`forecastHourly`, `forecastGridData`, `observationStations`, `timeZone`,
+`radarStation`, `county`, `fireWeatherZone`, and the nested
+`relativeLocation.properties` place label. A response that is not a GeoJSON
+feature, has no coordinate pair, or has no grid id, grid cell, forecast URL, or
+forecast office throws `UsSourceParseError`.
+
+Three shape notes. The point lookup returns the forecast grid and the URLs that
+lead to the forecast, not the forecast periods themselves; a caller that needs
+temperatures reads `forecastUrl` or `forecastHourlyUrl` next. Grid cell numbers
+are local to an office, so `gridX` 100 in one office and `gridX` 100 in another
+point at different places; always keep `gridId` next to the cell. The place
+label is the nearest place the service knows, not the caller's own name: a
+lookup for Tacoma came back as "Seattle" on 2026-10-20, and a lookup for
+Tacoma Old City Hall landed in office SEW at cell 125,68.
+
+`callook-callsigns`:
+
+```ts
+import { fetchCallookCallsigns } from '@usa-open-data-connectors/usa-sources';
+
+const directory = await fetchCallookCallsigns({ callsigns: ['W1AW'] });
+console.log(directory.callsigns[0]?.callsign, directory.soonestExpiry?.expiryDate);
+```
+
+Callook answers one callsign per request. The default fetch reads W1ABC through
+W0ABC, one callsign for each US call district. Pass `callsigns` to read a
+different set. The parser keeps a lookup with status `INVALID` or `UPDATING` as
+a record with no licence fields, and counts only `VALID` records in the folded
+totals.
+
+`college-scorecard-institutions`:
+
+```ts
+import { fetchCollegeScorecardInstitutions } from '@usa-open-data-connectors/usa-sources';
+
+const snapshot = await fetchCollegeScorecardInstitutions();
+console.log(snapshot.institutionCount, snapshot.highestEarningState?.stateAbbr);
+```
+
+The adapter reads the keyless institution-level bulk download, not the keyed
+College Scorecard API. The archive is a zip that holds one wide CSV, and a live
+fetch takes about 20 seconds on a fast connection.
+
 ## Notes and limits
 
 - `bls-unemployment-rate`: the public API refuses a window longer than ten years. `fetchBlsSeries` splits a longer range into windows, so two decades cost three calls once the range reaches the current year.
@@ -448,7 +557,7 @@ the page or ask for the total separately.
 - `treasury-avg-interest-rate`: a page holds at most 10,000 rows and the run is around 300. The adapter asks for the whole series in one request and does not page. The row limit is a named constant.
 - `treasury-avg-interest-rate`: each row is dated to the last day of its month. A month the agency could not compute arrives without a value, and the parser drops those rows.
 - `treasury-avg-interest-rate`: a request the API rejects answers with an HTTP error and a body of `{"error":"Invalid Query Param","message":"..."}`. The parser reports an API error rather than a shape error.
-- `treasury-debt-to-penny`: one keyless request covers the whole run if the row limit is raised. The file starts on 1993-04-01 and held 8,414 business-day rows on 2026-10-15, about 2.8 MB. The default `TREASURY_DEBT_TO_PENNY_ROW_LIMIT` is 10 and the API returns oldest first, so the default page is the first ten days of 1993 rather than recent debt. Pass `{ rowLimit: 10_000 }` to read the whole series in one request.
+- `treasury-debt-to-penny`: one keyless request covers the whole run if the row limit is raised. The file starts on 1993-04-01 and held 8,415 business-day rows on 2026-10-16, about 2.8 MB. The default `TREASURY_DEBT_TO_PENNY_ROW_LIMIT` is 10 and the API returns oldest first, so the default page is the first ten days of 1993 rather than recent debt. Pass `{ rowLimit: 10_000 }` to read the whole series in one request.
 - `treasury-debt-to-penny`: the API caps `page[size]` at 10,000 rows and the run still fits under that cap. A caller asking for more gets the cap's worth, so check `dayCount` against the API's `meta.count` when the run grows past it.
 - `treasury-debt-to-penny`: every value arrives as a string, and a figure the agency could not report arrives as the literal text `"null"`. The adapter reads that as null and drops a row with no total. The first row, 1993-04-01, has a total but no public or intragovernmental split.
 - `treasury-debt-to-penny`: `tot_pub_debt_out_amt` equals `debt_held_public_amt` plus `intragov_hold_amt` on the rows that carry all three. Keep the split fields when the story compares public debt with intragovernmental holdings, and use the total field for the headline.
@@ -500,16 +609,38 @@ the page or ask for the total separately.
 - `ncbi-pubmed-search`: keyless NCBI allows about three requests a second. The adapter makes one request per call and does not add a delay, so a caller reading six years must space the calls itself.
 - `ncbi-pubmed-search`: a query field tag such as `[tiab]` restricts the match to the title and abstract. Without a tag, PubMed maps the words through MeSH and searches every indexed field, which answers a wider and different count. `queryTranslation` shows what PubMed actually ran.
 - `ncbi-pubmed-search`: a bad query answers HTTP 200 with `esearchresult.error` instead of a result block. The parser turns that into `UsSourceApiError`, so a caller does not count an error as zero papers.
-- `cdc-socrata-catalogue`: the default request asks for ten rows. The discovery API answers the whole catalogue when the limit is high enough, and the CDC catalogue held 1,477 entries on 2026-10-19. Call `buildCdcSocrataCatalogueUrl({ limit: 10_000 })` or pass `limit` to `fetchCdcSocrataCatalogue` when you need every entry. A limit below the catalogue size truncates the response without an error.
+- `cdc-socrata-catalogue`: the default request asks for ten rows. The discovery API answers the whole catalogue when the limit is high enough, and the CDC catalogue held 1,478 entries on 2026-10-20. Call `buildCdcSocrataCatalogueUrl({ limit: 10_000 })` or pass `limit` to `fetchCdcSocrataCatalogue` when you need every entry. A limit below the catalogue size truncates the response without an error.
 - `cdc-socrata-catalogue`: each row is a catalogue entry, not a dataset record. `assetType` can be `dataset`, `file`, `href`, `filter`, `chart`, `story`, or `map`. A category can hold one type or a mix, so count the asset type before you describe a category as a dataset collection.
 - `cdc-socrata-catalogue`: an entry without a category has `null` in the response. The adapter keeps the null on the entry and counts it under `Uncategorised` in `categories`. That bucket is an adapter label, not a category the CDC assigned.
-- `cdc-socrata-catalogue`: the full response is large because each row carries portal metadata. The 1,477-row response was about 7.8 MB on 2026-10-19. The parser keeps nine fields, and a fixture trimmed to those fields was about 490 KB.
+- `cdc-socrata-catalogue`: the full response is large because each row carries portal metadata. The 1,478-row response was about 7.9 MB on 2026-10-20. The parser keeps nine fields, and a fixture trimmed to those fields was about 491 KB.
 - `cdc-socrata-catalogue`: the discovery API can carry rights and metadata fields, but this parser does not keep them. Check the portal entry before you reuse an item.
+- `bts-transportation-stats`: the default request asks for ten rows. The story that consumed this adapter needed the whole catalogue, so it calls `buildBtsTransportationStatsUrl({ limit: 10_000 })` and parses the full response with `parseBtsTransportationStatsPayload`. A lower limit truncates the catalogue without an error.
+- `bts-transportation-stats`: each row is a catalogue entry, not a dataset record. `assetType` can be `story`, `dataset`, `chart`, `measure`, `filter`, `href`, `map`, or `file`. The story and dataset counts are different questions, and the 2026-10-20 catalogue held 177 stories against 153 datasets.
+- `bts-transportation-stats`: `viewCount` and `downloadCount` are the portal's own counters for an item page and its files. They are not unique people. Stories carry views and a zero download count because Socrata does not give a story a download counter, while 268 entries reported no downloads at all on 2026-10-20.
+- `bts-transportation-stats`: the response is large because every entry carries portal metadata. The 589-row response was about 2.2 MB on 2026-10-20. The parser keeps nine fields, and a fixture trimmed to those fields was about 172 KB.
+- `bts-transportation-stats`: an entry without a category has `null` in the response. The adapter keeps the null on the entry and counts it under `Uncategorised` in `categories`. That bucket is an adapter label, not a category the bureau assigned.
 - `nyc-open-data-catalogue`: the discovery API answers a bare JSON array of catalogue entries, not dataset rows. An entry can arrive without a category, which the adapter counts under `Uncategorised`.
 - `nyc-open-data-catalogue`: the page captured on 2026-10-19 mixes datasets and maps. The adapter counts both, and keeps the view and download totals for the page it read.
 - Unit tests use the committed fixtures and run offline. Run them with `npm run test --workspace @usa-open-data-connectors/usa-sources`.
 - Smoke tests hit the live APIs and need `RUN_SMOKE=1`. Run them with `npm run test:smoke --workspace @usa-open-data-connectors/usa-sources`.
 
+- `nws-point-forecast`: one keyless request covers one coordinate. The service asks every caller to send a User-Agent that identifies the application, and `fetchNwsPointForecast` sends `NWS_USER_AGENT` on every call.
+- `nws-point-forecast`: the response is a GeoJSON feature whose `properties` hold the grid and the links. The forecast itself is a second request to `forecastUrl` (daily periods) or `forecastHourlyUrl` (hourly periods).
+- `nws-point-forecast`: `gridX` and `gridY` are numbered inside one forecast office. The same pair in two offices is not the same place, and there is no national grid coordinate in the response.
+- `nws-point-forecast`: `relativeLocation.properties` names the nearest place the service knows, which can be a neighboring city. A Tacoma lookup returned "Seattle", so a caller that needs its own label should keep it outside the response.
+- `nws-point-forecast`: one point response is about 3.5 KB. Twenty-five lookups cost twenty-five requests and about 88 KB of committed JSON when saved as a snapshot.
+- `callook-callsigns`: the service answers one callsign per request and has no bulk list endpoint. The default ten-district sample costs ten requests. The service asks for no key, and its API reference says the data comes from the FCC licence file, refreshed daily.
+- `callook-callsigns`: a lookup returns `INVALID` for a callsign with no current licence. The adapter keeps that answer as a record with status `INVALID` rather than treating it as an HTTP failure. A callsign with a current licence has status `VALID` and carries the licence fields.
+- `callook-callsigns`: coordinates and the grid square are calculated by Callook from the mailing address, not taken from the FCC file. A record can have an empty location. The adapter keeps the coordinates as null in that case and does not invent a place.
+- `college-scorecard-institutions`: the bulk archive is 24 MB and the CSV inside it is 102 MB. The adapter raises its request timeout to two minutes. The CSV has 3,379 columns, so the adapter reads only the outcome fields it exposes.
+- `college-scorecard-institutions`: `NA` and `PS` mean the Department of Education did not publish a figure. The adapter keeps those as null, so a chart does not turn a suppressed value into a zero.
+- `college-scorecard-institutions`: the state summary is a median of the institution medians, not a weighted student average. It answers "what does a typical college in this state report", not "what does a typical student earn".
+- `college-scorecard-institutions`: the earnings field is `MD_EARN_WNE_P10`, the median for graduates working and not enrolled ten years after entry. It is not a first-year salary.
+- `nextbus-transit-vehicles`: the adapter reads one agency route, the Portland Streetcar NS line (`portland-sc`, route `193`). The feed also serves other agencies, including non-US ones, so the adapter does not claim to cover every agency on the feed.
+- `nextbus-transit-vehicles`: `t=0` asks for every report the feed still holds for the route. The feed returns the current set of streetcars, not a history, so the snapshot describes one moment and is replaced on the next request.
+- `nextbus-transit-vehicles`: a route with no service returns a snapshot with zero vehicles and a valid timestamp. That is a real answer, not a failure, so the parser keeps it.
+- `nextbus-transit-vehicles`: the feed carries a copyright notice for the transit agency and Umo IQ, and states no open licence. Check the agency's terms before republishing the positions.
+
 ## Data sources and licences
 
 The data comes from US federal agencies and the open data catalogue services they publish on.
@@ -537,6 +668,8 @@ The data comes from US federal agencies and the open data catalogue services the
 | EstimateTax | `https://estimatetax.net/api/v1/calculate` |
 | HealthData.gov | `https://healthdata.gov/api/views.json` |
 | New York City Open Data | `https://data.cityofnewyork.us/api/views.json` |
+| Callook.info | `https://callook.info/[callsign]/json` |
+| College Scorecard, US Department of Education | `https://ed-public-download.scorecard.network/downloads/Most-Recent-Cohorts-Institution_10152026.zip` |
 
 Each publisher sets its own terms for its data. The Socrata discovery responses can carry rights and
 metadata fields, but the catalogue adapters in this package keep a subset of the entry fields and do not

package/dist/callookCallsigns.d.ts

@@ -0,0 +1,119 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the Callook.info amateur radio callsign source. */
+export declare const CALLOOK_CALLSIGNS_SOURCE_ID = "callook-callsigns";
+/** Base URL for the Callook.info callsign lookup service. */
+export declare const CALLOOK_API_BASE = "https://callook.info";
+/**
+ * One callsign for each of the ten US amateur radio call districts.
+ *
+ * Callook answers one callsign per request rather than exposing a bulk list.
+ * The W1ABC through W0ABC callsigns give the same lookup a ten-district
+ * sample, so the adapter can show how the licence file varies across the
+ * country instead of reporting a single record.
+ */
+export declare const CALLOOK_DISTRICT_CALLSIGNS: readonly string[];
+/** The three states Callook uses when a lookup has no licence record. */
+export type CallookLookupStatus = 'VALID' | 'INVALID' | 'UPDATING';
+/** One callsign lookup, with the licence fields flattened into plain names. */
+export interface CallookCallsign {
+    /** Whether Callook found a current licence for the callsign. */
+    status: CallookLookupStatus;
+    /** Current callsign, or an empty string when the lookup found no licence. */
+    callsign: string;
+    /** Licence type, e.g. "CLUB" or "PERSON", or an empty string when none. */
+    licenseType: string;
+    /** Operator class, e.g. "GENERAL" or "EXTRA", or an empty string when none. */
+    operatorClass: string;
+    /** Previous callsign held by the same licensee, or an empty string. */
+    previousCallsign: string;
+    /** Previous operator class held by the same licensee, or an empty string. */
+    previousOperatorClass: string;
+    /** Name of the licensee, or the club the licence belongs to. */
+    licenseeName: string;
+    /** Callsign of the club trustee, or an empty string for a personal licence. */
+    trusteeCallsign: string;
+    /** Name of the club trustee, or an empty string for a personal licence. */
+    trusteeName: string;
+    /** First line of the mailing address on the FCC record. */
+    addressLine1: string;
+    /** Second line of the mailing address, usually city, state, and ZIP code. */
+    addressLine2: string;
+    /** Attention line on the mailing address, or an empty string. */
+    attention: string;
+    /** Approximate latitude Callook calculated from the address, or null. */
+    latitude: number | null;
+    /** Approximate longitude Callook calculated from the address, or null. */
+    longitude: number | null;
+    /** Maidenhead grid square Callook calculated from the coordinates, or empty. */
+    gridsquare: string;
+    /** Licence grant date as YYYY-MM-DD, or null when Callook reports none. */
+    grantDate: string | null;
+    /** Licence expiry date as YYYY-MM-DD, or null when Callook reports none. */
+    expiryDate: string | null;
+    /** Date of the last FCC action on the licence, or null. */
+    lastActionDate: string | null;
+    /** FCC Registration Number, or an empty string. */
+    frn: string;
+    /** Link to the licence in the FCC ULS search, or an empty string. */
+    ulsUrl: string;
+    /** Two-letter state parsed from the mailing address, or an empty string. */
+    stateAbbr: string;
+    /** US call district digit taken from the callsign, or an empty string. */
+    callDistrict: string;
+}
+/** One label and how many records carry it. */
+export interface CallookLabelCount {
+    label: string;
+    count: number;
+}
+/** A batch of callsign lookups, folded for a story. */
+export interface CallookCallsignDirectory {
+    /** Every lookup in the batch, valid or not, in the order it was requested. */
+    callsigns: CallookCallsign[];
+    callsignCount: number;
+    validCount: number;
+    invalidCount: number;
+    updatingCount: number;
+    /** Licence types, most records first, ties broken by label. */
+    licenseTypeCounts: CallookLabelCount[];
+    /** Operator classes, most records first, ties broken by label. */
+    operatorClassCounts: CallookLabelCount[];
+    /** How many different call districts the valid records cover. */
+    callDistrictCount: number;
+    /** Valid record with the earliest expiry date, or null when none has one. */
+    soonestExpiry: CallookCallsign | null;
+    /** Valid record with the latest expiry date, or null when none has one. */
+    latestExpiry: CallookCallsign | null;
+}
+/** Builds the request URL for one callsign lookup. */
+export declare function buildCallookCallsignUrl(callsign: string): string;
+/** Folds a list of callsign records into the shape the page reads. */
+export declare function buildCallookCallsignDirectory(callsigns: CallookCallsign[]): CallookCallsignDirectory;
+/**
+ * Parses a batch of Callook lookup responses.
+ *
+ * A lookup with status INVALID or UPDATING is a valid answer from the service
+ * and stays in `callsigns`, but it carries no licence fields and does not
+ * contribute to the counts. A VALID record without a current callsign is a
+ * changed shape and stops the parse.
+ *
+ * @param payload - an array of JSON bodies, one per callsign lookup
+ * @returns the records and the folded counts
+ */
+export declare function parseCallookCallsignsPayload(payload: unknown): CallookCallsignDirectory;
+/**
+ * Reads one Callook lookup for each callsign.
+ *
+ * The service answers one callsign per request and needs no key. When the
+ * caller names no callsigns, the adapter reads the ten-district sample.
+ *
+ * @param options - an optional callsign list and fetch stub
+ * @returns the records and the folded counts
+ */
+export declare function fetchCallookCallsigns(options?: {
+    callsigns?: readonly string[];
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<CallookCallsignDirectory>;
+/** Callook.info US amateur radio callsigns, one record per lookup, keyless. */
+export declare const callookCallsignsAdapter: UsDataAdapter<CallookCallsignDirectory>;
+//# sourceMappingURL=callookCallsigns.d.ts.map

package/dist/callookCallsigns.d.ts.map

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

package/dist/callookCallsigns.js

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the Callook.info amateur radio callsign source. */
+export const CALLOOK_CALLSIGNS_SOURCE_ID = 'callook-callsigns';
+/** Base URL for the Callook.info callsign lookup service. */
+export const CALLOOK_API_BASE = 'https://callook.info';
+/**
+ * One callsign for each of the ten US amateur radio call districts.
+ *
+ * Callook answers one callsign per request rather than exposing a bulk list.
+ * The W1ABC through W0ABC callsigns give the same lookup a ten-district
+ * sample, so the adapter can show how the licence file varies across the
+ * country instead of reporting a single record.
+ */
+export const CALLOOK_DISTRICT_CALLSIGNS = [
+    'W1ABC',
+    'W2ABC',
+    'W3ABC',
+    'W4ABC',
+    'W5ABC',
+    'W6ABC',
+    'W7ABC',
+    'W8ABC',
+    'W9ABC',
+    'W0ABC',
+];
+/** Committed snapshot, so a build works when Callook is unreachable. */
+const CALLOOK_CALLSIGNS_FIXTURE_FILENAME = 'callook-callsigns-2026-10-21.json';
+/** Shape of a US amateur radio callsign, without spaces or punctuation. */
+const CALLSIGN_PATTERN = /^[A-Z0-9]{3,10}$/;
+/** Shape of the dates Callook writes, e.g. "03/24/2036". */
+const CALLOOK_DATE_PATTERN = /^(\d{2})\/(\d{2})\/(\d{4})$/;
+/** Shape of a US mailing address line ending in a state and ZIP code. */
+const STATE_AND_ZIP_PATTERN = /\b([A-Z]{2})\s+\d{5}(?:-\d{4})?\s*$/;
+const CALLOOK_ADDRESS_SCHEMA = z.object({
+    line1: z.string().optional(),
+    line2: z.string().optional(),
+    attn: z.string().optional(),
+});
+const CALLOOK_LOCATION_SCHEMA = z.object({
+    latitude: z.string().optional(),
+    longitude: z.string().optional(),
+    gridsquare: z.string().optional(),
+});
+const CALLOOK_OTHER_INFO_SCHEMA = z.object({
+    grantDate: z.string().optional(),
+    expiryDate: z.string().optional(),
+    lastActionDate: z.string().optional(),
+    frn: z.string().optional(),
+    ulsUrl: z.string().optional(),
+});
+const CALLOOK_NAME_SCHEMA = z.object({
+    callsign: z.string().optional(),
+    operClass: z.string().optional(),
+    name: z.string().optional(),
+});
+const CALLOOK_CALLSIGN_SCHEMA = z.object({
+    status: z.enum(['VALID', 'INVALID', 'UPDATING']),
+    type: z.string().optional(),
+    current: CALLOOK_NAME_SCHEMA.optional(),
+    previous: CALLOOK_NAME_SCHEMA.optional(),
+    trustee: CALLOOK_NAME_SCHEMA.optional(),
+    name: z.string().optional(),
+    address: CALLOOK_ADDRESS_SCHEMA.optional(),
+    location: CALLOOK_LOCATION_SCHEMA.optional(),
+    otherInfo: CALLOOK_OTHER_INFO_SCHEMA.optional(),
+});
+const CALLOOK_CALLSIGNS_SCHEMA = z.array(CALLOOK_CALLSIGN_SCHEMA);
+/** Builds the request URL for one callsign lookup. */
+export function buildCallookCallsignUrl(callsign) {
+    const normalized = callsign.trim().toUpperCase();
+    if (!CALLSIGN_PATTERN.test(normalized)) {
+        throw new UsSourceParseError(CALLOOK_CALLSIGNS_SOURCE_ID, `A callsign must be 3 to 10 letters or digits: ${callsign}`);
+    }
+    return `${CALLOOK_API_BASE}/${normalized}/json`;
+}
+/** Converts Callook's MM/DD/YYYY date to YYYY-MM-DD, or null when unreadable. */
+function toIsoDate(value) {
+    if (value === undefined || value.trim() === '') {
+        return null;
+    }
+    const match = CALLOOK_DATE_PATTERN.exec(value.trim());
+    if (match === null) {
+        return null;
+    }
+    const [, month, day, year] = match;
+    return `${year}-${month}-${day}`;
+}
+/** Reads a numeric coordinate from Callook's string field, or null. */
+function toCoordinate(value) {
+    if (value === undefined || value.trim() === '') {
+        return null;
+    }
+    const coordinate = Number(value);
+    return Number.isFinite(coordinate) ? coordinate : null;
+}
+/** Reads the two-letter state from the end of a mailing address line. */
+function toStateAbbr(addressLine2) {
+    return STATE_AND_ZIP_PATTERN.exec(addressLine2)?.[1] ?? '';
+}
+/** Reads the first digit in a callsign as its US call district. */
+function toCallDistrict(callsign) {
+    return /\d/.exec(callsign)?.[0] ?? '';
+}
+/** Builds an empty record for a lookup that found no current licence. */
+function emptyCallookCallsign(status) {
+    return {
+        status,
+        callsign: '',
+        licenseType: '',
+        operatorClass: '',
+        previousCallsign: '',
+        previousOperatorClass: '',
+        licenseeName: '',
+        trusteeCallsign: '',
+        trusteeName: '',
+        addressLine1: '',
+        addressLine2: '',
+        attention: '',
+        latitude: null,
+        longitude: null,
+        gridsquare: '',
+        grantDate: null,
+        expiryDate: null,
+        lastActionDate: null,
+        frn: '',
+        ulsUrl: '',
+        stateAbbr: '',
+        callDistrict: '',
+    };
+}
+/** Counts labels in a record list, most records first, ties by label. */
+function countLabels(labels) {
+    const counts = new Map();
+    for (const label of labels) {
+        if (label !== '') {
+            counts.set(label, (counts.get(label) ?? 0) + 1);
+        }
+    }
+    return [...counts.entries()]
+        .sort(([leftLabel, leftCount], [rightLabel, rightCount]) => leftCount === rightCount ? leftLabel.localeCompare(rightLabel) : rightCount - leftCount)
+        .map(([label, count]) => ({ label, count }));
+}
+/** Picks the valid record with the earliest or latest date in one field. */
+function edgeByDate(callsigns, direction) {
+    let edge = null;
+    let edgeDate = null;
+    for (const callsign of callsigns) {
+        const value = callsign.expiryDate;
+        if (value === null) {
+            continue;
+        }
+        if (edgeDate === null || (direction === 'earliest' ? value < edgeDate : value > edgeDate)) {
+            edge = callsign;
+            edgeDate = value;
+        }
+    }
+    return edge;
+}
+/** Folds a list of callsign records into the shape the page reads. */
+export function buildCallookCallsignDirectory(callsigns) {
+    const valid = callsigns.filter((callsign) => callsign.status === 'VALID');
+    return {
+        callsigns,
+        callsignCount: callsigns.length,
+        validCount: valid.length,
+        invalidCount: callsigns.filter((callsign) => callsign.status === 'INVALID').length,
+        updatingCount: callsigns.filter((callsign) => callsign.status === 'UPDATING').length,
+        licenseTypeCounts: countLabels(valid.map((callsign) => callsign.licenseType)),
+        operatorClassCounts: countLabels(valid.map((callsign) => callsign.operatorClass)),
+        callDistrictCount: new Set(valid.map((callsign) => callsign.callDistrict).filter((district) => district !== '')).size,
+        soonestExpiry: edgeByDate(valid, 'earliest'),
+        latestExpiry: edgeByDate(valid, 'latest'),
+    };
+}
+/**
+ * Parses a batch of Callook lookup responses.
+ *
+ * A lookup with status INVALID or UPDATING is a valid answer from the service
+ * and stays in `callsigns`, but it carries no licence fields and does not
+ * contribute to the counts. A VALID record without a current callsign is a
+ * changed shape and stops the parse.
+ *
+ * @param payload - an array of JSON bodies, one per callsign lookup
+ * @returns the records and the folded counts
+ */
+export function parseCallookCallsignsPayload(payload) {
+    const parsed = CALLOOK_CALLSIGNS_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(CALLOOK_CALLSIGNS_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.length === 0) {
+        throw new UsSourceParseError(CALLOOK_CALLSIGNS_SOURCE_ID, 'The response carried no lookups');
+    }
+    const callsigns = parsed.data.map((record) => {
+        if (record.status !== 'VALID') {
+            return emptyCallookCallsign(record.status);
+        }
+        const currentCallsign = record.current?.callsign;
+        if (currentCallsign === undefined || currentCallsign === '') {
+            throw new UsSourceParseError(CALLOOK_CALLSIGNS_SOURCE_ID, 'A valid lookup arrived without a current callsign');
+        }
+        const addressLine2 = record.address?.line2 ?? '';
+        return {
+            status: record.status,
+            callsign: currentCallsign,
+            licenseType: record.type ?? '',
+            operatorClass: record.current?.operClass ?? '',
+            previousCallsign: record.previous?.callsign ?? '',
+            previousOperatorClass: record.previous?.operClass ?? '',
+            licenseeName: record.name ?? '',
+            trusteeCallsign: record.trustee?.callsign ?? '',
+            trusteeName: record.trustee?.name ?? '',
+            addressLine1: record.address?.line1 ?? '',
+            addressLine2,
+            attention: record.address?.attn ?? '',
+            latitude: toCoordinate(record.location?.latitude),
+            longitude: toCoordinate(record.location?.longitude),
+            gridsquare: record.location?.gridsquare ?? '',
+            grantDate: toIsoDate(record.otherInfo?.grantDate),
+            expiryDate: toIsoDate(record.otherInfo?.expiryDate),
+            lastActionDate: toIsoDate(record.otherInfo?.lastActionDate),
+            frn: record.otherInfo?.frn ?? '',
+            ulsUrl: record.otherInfo?.ulsUrl ?? '',
+            stateAbbr: toStateAbbr(addressLine2),
+            callDistrict: toCallDistrict(currentCallsign),
+        };
+    });
+    return buildCallookCallsignDirectory(callsigns);
+}
+/**
+ * Reads one Callook lookup for each callsign.
+ *
+ * The service answers one callsign per request and needs no key. When the
+ * caller names no callsigns, the adapter reads the ten-district sample.
+ *
+ * @param options - an optional callsign list and fetch stub
+ * @returns the records and the folded counts
+ */
+export async function fetchCallookCallsigns(options) {
+    const callsigns = options?.callsigns ?? CALLOOK_DISTRICT_CALLSIGNS;
+    if (callsigns.length === 0) {
+        throw new UsSourceParseError(CALLOOK_CALLSIGNS_SOURCE_ID, 'No callsigns were requested');
+    }
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const payloads = await Promise.all(callsigns.map(async (callsign) => {
+        const response = await httpGet(CALLOOK_CALLSIGNS_SOURCE_ID, buildCallookCallsignUrl(callsign), { fetchImpl });
+        return (await response.json());
+    }));
+    return parseCallookCallsignsPayload(payloads);
+}
+/** Callook.info US amateur radio callsigns, one record per lookup, keyless. */
+export const callookCallsignsAdapter = {
+    id: CALLOOK_CALLSIGNS_SOURCE_ID,
+    name: 'Callook callsigns',
+    auth: 'none',
+    description: 'US amateur radio callsign records from the FCC licence file, looked up through Callook.info, with the licence class, address, location, and expiry for each callsign.',
+    fetchLive: async (options) => fetchCallookCallsigns(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseCallookCallsignsPayload(payload),
+    loadFixture: () => parseCallookCallsignsPayload(readFixtureJson(CALLOOK_CALLSIGNS_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=callookCallsigns.js.map

package/dist/callookCallsigns.js.map

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