@usa-open-data-connectors/usa-sources 0.1.0

package/dist/femaDisasterDeclarations.js

@@ -0,0 +1,214 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Base URL for the OpenFEMA API. */
+export const FEMA_OPEN_DATA_API_BASE = 'https://www.fema.gov/api/open/v1';
+/** Dataset path for the web disaster declarations file. */
+export const FEMA_DECLARATION_PATH = '/FemaWebDisasterDeclarations';
+/**
+ * Row cap for one request.
+ *
+ * The file carries a little over five thousand declarations from 1953 on,
+ * so one request covers it and the adapter never pages. A file that outgrows
+ * the cap is caught by the parser rather than silently truncated.
+ */
+export const FEMA_DECLARATION_ROW_LIMIT = 10_000;
+/**
+ * Incident type the file uses for wildfire declarations.
+ *
+ * Fires arrive under several declaration programs (Fire Management, Fire
+ * Suppression, and occasionally Major Disaster), so the incident type is what
+ * the adapter counts rather than the program.
+ */
+export const FEMA_FIRE_INCIDENT_TYPE = 'Fire';
+/** Columns the adapter asks for. The dataset carries about twenty more. */
+const FEMA_DECLARATION_COLUMNS = 'disasterNumber,declarationDate,declarationType,incidentType,stateCode,stateName';
+/** Committed snapshot, so a build works when the FEMA host is unreachable. */
+const FEMA_DECLARATION_FIXTURE_FILENAME = 'fema-disaster-declarations-2026-09-29.json';
+/** Shape of the agency's declaration date, e.g. "2026-09-15T00:00:00.000Z". */
+const ISO_DATE_PATTERN = /^(\d{4})-\d{2}-\d{2}/;
+// Every field arrives as a string, and a row the agency could not complete
+// arrives with the field missing. A rejected request answers with HTTP 400
+// and a body of {error: [{code, type, message}]} instead of the data.
+const FEMA_ROW_SCHEMA = z.object({
+    disasterNumber: z.number().optional(),
+    declarationDate: z.string().optional(),
+    declarationType: z.string().optional(),
+    incidentType: z.string().optional(),
+    stateCode: z.string().optional(),
+    stateName: z.string().optional(),
+});
+const FEMA_ERROR_SCHEMA = z.object({
+    name: z.string().optional(),
+    code: z.string().optional(),
+    type: z.string().optional(),
+    message: z.string().optional(),
+});
+const FEMA_PAYLOAD_SCHEMA = z.object({
+    metadata: z.object({ count: z.number().optional() }).optional(),
+    FemaWebDisasterDeclarations: z.array(FEMA_ROW_SCHEMA).optional(),
+    error: z.array(FEMA_ERROR_SCHEMA).optional(),
+});
+/**
+ * Builds the request URL for the whole declaration file.
+ *
+ * The endpoint is keyless. The row cap is high enough that one request
+ * covers the file, and the inline count lets the parser tell a complete
+ * response from a truncated one.
+ *
+ * @param options - an optional row cap
+ * @returns the full request URL
+ */
+export function buildFemaDeclarationUrl(options) {
+    const params = new URLSearchParams({
+        $select: FEMA_DECLARATION_COLUMNS,
+        $orderby: 'disasterNumber',
+        $inlinecount: 'allpages',
+        $top: String(options?.rowLimit ?? FEMA_DECLARATION_ROW_LIMIT),
+    });
+    return `${FEMA_OPEN_DATA_API_BASE}${FEMA_DECLARATION_PATH}?${params.toString()}`;
+}
+/**
+ * Parses one response into the declarations it carries.
+ *
+ * A row without the fields the story reads stops the parse, so a changed
+ * response shape cannot quietly produce a half-empty file. A response whose
+ * row count falls short of the agency's own count means the file has outgrown
+ * the request and is also refused, rather than truncated.
+ *
+ * @param payload - the JSON body from the OpenFEMA API
+ * @returns the declarations, in the order the agency sent them
+ */
+export function parseFemaDeclarationPayload(payload) {
+    const parsed = FEMA_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('fema', parsed.error.message);
+    }
+    const firstError = parsed.data.error?.[0];
+    if (firstError !== undefined) {
+        throw new UsSourceApiError('fema', `${firstError.type ?? 'error'}: ${firstError.message ?? firstError.code ?? 'rejected'}`);
+    }
+    const rows = parsed.data.FemaWebDisasterDeclarations ?? [];
+    if (rows.length === 0) {
+        throw new UsSourceParseError('fema', 'The response carried no declarations');
+    }
+    const reportedCount = parsed.data.metadata?.count;
+    if (reportedCount !== undefined && reportedCount > rows.length) {
+        throw new UsSourceParseError('fema', `The file holds ${String(reportedCount)} declarations and the request returned ${String(rows.length)}`);
+    }
+    const declarations = [];
+    for (const row of rows) {
+        const { disasterNumber, declarationDate, declarationType, incidentType } = row;
+        if (disasterNumber === undefined ||
+            declarationDate === undefined ||
+            declarationType === undefined ||
+            incidentType === undefined ||
+            row.stateCode === undefined ||
+            row.stateName === undefined) {
+            throw new UsSourceParseError('fema', `A declaration row is missing a field: ${JSON.stringify(row)}`);
+        }
+        const match = ISO_DATE_PATTERN.exec(declarationDate);
+        if (match === null) {
+            throw new UsSourceParseError('fema', `Unreadable declaration date: ${declarationDate}`);
+        }
+        declarations.push({
+            disasterNumber,
+            declarationDate,
+            year: Number(match[1]),
+            declarationType,
+            incidentType,
+            stateCode: row.stateCode,
+            stateName: row.stateName,
+        });
+    }
+    return declarations;
+}
+/** Counts how often each value of a field appears, most first then by name. */
+function countBy(declarations, pick) {
+    const counts = new Map();
+    for (const declaration of declarations) {
+        const key = pick(declaration);
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .map(([name, count]) => ({ name, count }))
+        .sort((left, right) => right.count - left.count || left.name.localeCompare(right.name));
+}
+/**
+ * Folds the parsed file into the per-year and per-value counts a story reads.
+ *
+ * The years run from the oldest declaration in the file to the newest, and
+ * the newest one is a partial year whenever the current year is still open.
+ *
+ * @param declarations - the parsed declarations, in any order
+ * @returns the per-year counts, the busiest year, and the value counts
+ */
+export function buildFemaDeclarationCatalogue(declarations) {
+    if (declarations.length === 0) {
+        throw new UsSourceParseError('fema', 'No declarations to summarise');
+    }
+    const sorted = [...declarations].sort((left, right) => left.year - right.year);
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    if (first === undefined || last === undefined) {
+        throw new UsSourceParseError('fema', 'No declarations to summarise');
+    }
+    const yearTotals = new Map();
+    for (const declaration of sorted) {
+        const entry = yearTotals.get(declaration.year) ?? {
+            year: declaration.year,
+            total: 0,
+            fire: 0,
+        };
+        entry.total += 1;
+        if (declaration.incidentType === FEMA_FIRE_INCIDENT_TYPE) {
+            entry.fire += 1;
+        }
+        yearTotals.set(declaration.year, entry);
+    }
+    const years = [...yearTotals.values()].sort((left, right) => left.year - right.year);
+    const busiestYear = years.reduce((busiest, year) => year.total > busiest.total ? year : busiest);
+    const fireDeclarations = sorted.filter((declaration) => declaration.incidentType === FEMA_FIRE_INCIDENT_TYPE);
+    return {
+        declarations: sorted,
+        declarationCount: sorted.length,
+        firstYear: first.year,
+        newestYear: last.year,
+        years,
+        busiestYear,
+        fireCount: fireDeclarations.length,
+        firstFireYear: fireDeclarations[0]?.year ?? first.year,
+        incidentTypes: countBy(sorted, (declaration) => declaration.incidentType),
+        declarationTypes: countBy(sorted, (declaration) => declaration.declarationType),
+        topStates: countBy(sorted, (declaration) => declaration.stateCode),
+    };
+}
+/**
+ * Reads the OpenFEMA disaster declaration file.
+ *
+ * One keyless request covers the whole file, from the 1953 declarations to
+ * the newest one the agency has published.
+ *
+ * @param options - an optional row cap and fetch stub
+ * @returns the declarations and the counts the story reads
+ */
+export async function fetchFemaDeclarations(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildFemaDeclarationUrl(options?.rowLimit === undefined ? {} : { rowLimit: options.rowLimit });
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError('fema', `HTTP ${response.status} reading the declaration file`);
+    }
+    return buildFemaDeclarationCatalogue(parseFemaDeclarationPayload(await response.json()));
+}
+/** FEMA disaster declarations, keyless. */
+export const femaDisasterDeclarationsAdapter = {
+    id: 'fema-disaster-declarations',
+    name: 'FEMA disaster declarations',
+    auth: 'none',
+    description: 'Every disaster declaration FEMA has published, one row per declaration, from 1953 to the newest declaration.',
+    fetchLive: async (options) => fetchFemaDeclarations(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => buildFemaDeclarationCatalogue(parseFemaDeclarationPayload(payload)),
+    loadFixture: () => buildFemaDeclarationCatalogue(parseFemaDeclarationPayload(readFixtureJson(FEMA_DECLARATION_FIXTURE_FILENAME))),
+};
+//# sourceMappingURL=femaDisasterDeclarations.js.map

package/dist/femaDisasterDeclarations.js.map

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

package/dist/fixtures.d.ts

@@ -0,0 +1,5 @@
+/** Reads a committed fixture from src/fixtures as parsed JSON. */
+export declare function readFixtureJson(filename: string): unknown;
+/** Reads a committed fixture from src/fixtures as raw text. */
+export declare function readFixtureText(filename: string): string;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/fixtures.js

@@ -0,0 +1,11 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+/** Reads a committed fixture from src/fixtures as parsed JSON. */
+export function readFixtureJson(filename) {
+    return JSON.parse(readFileSync(path.join(process.cwd(), 'src/fixtures', filename), 'utf8'));
+}
+/** Reads a committed fixture from src/fixtures as raw text. */
+export function readFixtureText(filename) {
+    return readFileSync(path.join(process.cwd(), 'src/fixtures', filename), 'utf8');
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/** Errors shared by every US source adapter. */
+export { UsSourceApiError, UsSourceError, UsSourceParseError } from './errors.js';
+/** Bureau of Labor Statistics time series (keyless). */
+export { BLS_API_BASE, BLS_MAX_YEARS_PER_REQUEST, blsUnemploymentAdapter, buildBlsSeries, fetchBlsSeries, parseBlsObservations, US_UNEMPLOYMENT_SERIES_ID, US_UNEMPLOYMENT_SERIES_LABEL, } from './blsSeries.js';
+/** BLS series types. */
+export type { BlsObservation, BlsSeries } from './blsSeries.js';
+/** USGS earthquake catalogue (keyless). */
+export { buildUsgsEarthquakeCatalogue, buildUsgsEarthquakeUrl, fetchUsgsEarthquakes, parseUsgsEarthquakes, sortEarthquakesOldestFirst, USGS_EARTHQUAKE_API_BASE, USGS_HAWAII_BOUNDS, USGS_HAWAII_MIN_MAGNITUDE, USGS_ROLLING_WINDOW_DAYS, usgsHawaiiEarthquakesAdapter, usgsHawaiiRollingWindow, } from './usgsEarthquakes.js';
+/** USGS earthquake types. */
+export type { UsgsEarthquake, UsgsEarthquakeBounds, UsgsEarthquakeCatalogue, UsgsEarthquakeQuery, } from './usgsEarthquakes.js';
+/** CDC PLACES county obesity estimates (keyless). */
+export { buildCdcCountyObesitySet, buildCdcCountyObesityUrl, cdcCountyObesityAdapter, CDC_PLACES_COUNTY_API_BASE, CDC_PLACES_COUNTY_ROW_LIMIT, CDC_PLACES_CRUDE_PREVALENCE_ID, CDC_PLACES_NATIONAL_STATE_CODE, CDC_PLACES_OBESITY_MEASURE_ID, fetchCdcCountyObesity, parseCdcCountyObesityPayload, sortCdcCountiesByPercent, } from './cdcCountyObesity.js';
+/** CDC PLACES county obesity types. */
+export type { CdcCountyObesityEstimate, CdcCountyObesityPayload, CdcCountyObesitySet, CdcNationalObesityEstimate, } from './cdcCountyObesity.js';
+/** NOAA NCEI contiguous US annual average temperature (keyless). */
+export { buildNceiAnnualTemperatureSeries, buildNceiAnnualTemperatureUrl, fetchNceiAnnualTemperature, NCEI_ANNUAL_WINDOW_MONTHS, NCEI_AVERAGE_TEMPERATURE_PARAMETER_ID, NCEI_CLIMATE_AT_A_GLANCE_BASE, NCEI_CONTIGUOUS_US_REGION_ID, NCEI_FIRST_RECORD_YEAR, nceiAnnualTemperatureAdapter, parseNceiAnnualTemperatureCsv, } from './nceiAnnualTemperature';
+/** NOAA NCEI temperature types. */
+export type { NceiTemperatureQuery, NceiTemperatureSeries, NceiTemperatureYear, } from './nceiAnnualTemperature';
+/** NOAA CO-OPS monthly mean sea level at a tide gauge (keyless). */
+export { buildNoaaSeaLevelSeries, buildNoaaSeaLevelUrl, fetchNoaaSeaLevel, noaaSeaLevelAdapter, noaaSeaLevelTrendMillimetresPerYear, NOAA_BATTERY_STATION_ID, NOAA_BATTERY_STATION_NAME, NOAA_COOPS_API_BASE, NOAA_SEA_LEVEL_APPLICATION_ID, NOAA_SEA_LEVEL_DATUM, NOAA_SEA_LEVEL_FIRST_YEAR, NOAA_SEA_LEVEL_PRODUCT, NOAA_SEA_LEVEL_UNITS, parseNoaaSeaLevelPayload, } from './noaaSeaLevel';
+/** NOAA CO-OPS sea level types. */
+export type { NoaaSeaLevelMonth, NoaaSeaLevelPayload, NoaaSeaLevelQuery, NoaaSeaLevelSeries, NoaaSeaLevelStation, NoaaSeaLevelYear, } from './noaaSeaLevel';
+/** The uniform adapter registry and probe helpers. */
+export { US_DATA_SOURCES, getUsDataSource, probeAllUsDataSources, probeUsDataSource, } from './registry.js';
+/** US Treasury average interest rate on the debt outstanding (keyless). */
+export { buildTreasuryAvgInterestRateSeries, buildTreasuryAvgInterestRateUrl, fetchTreasuryAvgInterestRates, parseTreasuryAvgInterestRatePayload, treasuryAvgInterestRateAdapter, TREASURY_AVG_INTEREST_RATE_FIRST_YEAR, TREASURY_AVG_INTEREST_RATE_PATH, TREASURY_AVG_INTEREST_RATE_ROW_LIMIT, TREASURY_AVG_INTEREST_RATE_SECURITY_DESCRIPTION, TREASURY_AVG_INTEREST_RATE_SECURITY_TYPE, TREASURY_FISCAL_DATA_API_BASE, } from './treasuryAvgInterestRate.js';
+/** Treasury interest rate types. */
+export type { TreasuryInterestRateMonth, TreasuryInterestRateSeries, } from './treasuryAvgInterestRate.js';
+/** FEMA disaster declarations (keyless). */
+export { buildFemaDeclarationCatalogue, buildFemaDeclarationUrl, femaDisasterDeclarationsAdapter, fetchFemaDeclarations, FEMA_DECLARATION_PATH, FEMA_DECLARATION_ROW_LIMIT, FEMA_FIRE_INCIDENT_TYPE, FEMA_OPEN_DATA_API_BASE, parseFemaDeclarationPayload, } from './femaDisasterDeclarations.js';
+/** FEMA declaration types. */
+export type { FemaDeclaration, FemaDeclarationCatalogue, FemaDeclarationCount, FemaDeclarationYear, } from './femaDisasterDeclarations.js';
+/** openFDA food enforcement reports (keyless). */
+export { buildOpenFdaFoodRecallCountUrl, buildOpenFdaFoodRecallSummary, buildOpenFdaFoodRecallTotalUrl, fetchOpenFdaFoodRecalls, openFdaFoodRecallsAdapter, openFdaReportDateLabel, OPENFDA_CLASSIFICATION_COUNT_FIELD, OPENFDA_CLASS_ONE, OPENFDA_FOOD_ENFORCEMENT_BASE, OPENFDA_MANDATED_TERM, OPENFDA_REPORT_DATE_FIELD, OPENFDA_VOLUNTARY_COUNT_FIELD, OPENFDA_VOLUNTARY_TERM, parseOpenFdaFoodRecallSnapshot, parseOpenFdaRecallCounts, parseOpenFdaRecallDateCounts, parseOpenFdaRecallTotal, } from './openFdaFoodRecalls.js';
+/** openFDA food recall types. */
+export type { OpenFdaFoodRecallSnapshot, OpenFdaFoodRecallSummary, OpenFdaFoodRecallYear, OpenFdaRecallCount, OpenFdaRecallDateCount, } from './openFdaFoodRecalls.js';
+/** USGS annual peak streamflow at a gauge (keyless). */
+export { buildUsgsPeakStreamflowSeries, buildUsgsPeakStreamflowUrl, fetchUsgsPeakStreamflow, parseUsgsPeakStreamflowPayload, USGS_DISCHARGE_PARAMETER_CODE, USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID, USGS_MISSISSIPPI_ST_LOUIS_LOCATION_NAME, USGS_PEAK_STREAMFLOW_COLLECTION, USGS_PEAK_STREAMFLOW_FIRST_WATER_YEAR, USGS_PEAK_STREAMFLOW_ROW_LIMIT, USGS_WATER_DATA_API_BASE, usgsPeakStreamflowAdapter, } from './usgsPeakStreamflow.js';
+/** USGS peak-streamflow types. */
+export type { UsgsPeakStreamflowSeries, UsgsPeakStreamflowYear } from './usgsPeakStreamflow.js';
+/** CPSC consumer product recalls (keyless). */
+export { buildCpscProductRecallSeries, buildCpscRecallUrl, CPSC_ERROR_RECALL_ID, CPSC_RECALL_API_BASE, CPSC_RECALL_FIRST_YEAR, cpscProductRecallsAdapter, fetchCpscProductRecalls, parseCpscRecallPayload, parseCpscRecallSnapshot, } from './cpscProductRecalls.js';
+/** CPSC product recall types. */
+export type { CpscManufacturerCountryCount, CpscProductRecall, CpscProductRecallSeries, CpscRemedyOptionCount, CpscRecallWindow, CpscRecallYearCount, } from './cpscProductRecalls.js';
+/** CFPB Consumer Complaint Database (keyless). */
+export { buildCfpComplaintAggregationUrl, buildCfpComplaintCountUrl, buildCfpComplaintDayUrl, buildCfpConsumerComplaintSeries, CFPB_COMPLAINT_FIRST_YEAR, CFPB_COMPLAINT_SEARCH_API_BASE, CFPB_NEWEST_DATE_PROBE_DAYS, CFPB_TOP_LIST_LIMIT, cfpbConsumerComplaintsAdapter, fetchCfpConsumerComplaints, findNewestCfpComplaintDate, parseCfpComplaintAggregations, parseCfpComplaintSnapshot, parseCfpComplaintTotal, } from './cfpbConsumerComplaints.js';
+/** CFPB complaint types. */
+export type { CfpComplaintCompanyCount, CfpComplaintProductCount, CfpComplaintYearCount, CfpConsumerComplaintSeries, } from './cfpbConsumerComplaints.js';
+/** Shared adapter contract types. */
+export type { UsDataAdapter, UsFetchOptions, UsSourceAuth, UsSourceProbe } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,27 @@
+/** Errors shared by every US source adapter. */
+export { UsSourceApiError, UsSourceError, UsSourceParseError } from './errors.js';
+/** Bureau of Labor Statistics time series (keyless). */
+export { BLS_API_BASE, BLS_MAX_YEARS_PER_REQUEST, blsUnemploymentAdapter, buildBlsSeries, fetchBlsSeries, parseBlsObservations, US_UNEMPLOYMENT_SERIES_ID, US_UNEMPLOYMENT_SERIES_LABEL, } from './blsSeries.js';
+/** USGS earthquake catalogue (keyless). */
+export { buildUsgsEarthquakeCatalogue, buildUsgsEarthquakeUrl, fetchUsgsEarthquakes, parseUsgsEarthquakes, sortEarthquakesOldestFirst, USGS_EARTHQUAKE_API_BASE, USGS_HAWAII_BOUNDS, USGS_HAWAII_MIN_MAGNITUDE, USGS_ROLLING_WINDOW_DAYS, usgsHawaiiEarthquakesAdapter, usgsHawaiiRollingWindow, } from './usgsEarthquakes.js';
+/** CDC PLACES county obesity estimates (keyless). */
+export { buildCdcCountyObesitySet, buildCdcCountyObesityUrl, cdcCountyObesityAdapter, CDC_PLACES_COUNTY_API_BASE, CDC_PLACES_COUNTY_ROW_LIMIT, CDC_PLACES_CRUDE_PREVALENCE_ID, CDC_PLACES_NATIONAL_STATE_CODE, CDC_PLACES_OBESITY_MEASURE_ID, fetchCdcCountyObesity, parseCdcCountyObesityPayload, sortCdcCountiesByPercent, } from './cdcCountyObesity.js';
+/** NOAA NCEI contiguous US annual average temperature (keyless). */
+export { buildNceiAnnualTemperatureSeries, buildNceiAnnualTemperatureUrl, fetchNceiAnnualTemperature, NCEI_ANNUAL_WINDOW_MONTHS, NCEI_AVERAGE_TEMPERATURE_PARAMETER_ID, NCEI_CLIMATE_AT_A_GLANCE_BASE, NCEI_CONTIGUOUS_US_REGION_ID, NCEI_FIRST_RECORD_YEAR, nceiAnnualTemperatureAdapter, parseNceiAnnualTemperatureCsv, } from './nceiAnnualTemperature';
+/** NOAA CO-OPS monthly mean sea level at a tide gauge (keyless). */
+export { buildNoaaSeaLevelSeries, buildNoaaSeaLevelUrl, fetchNoaaSeaLevel, noaaSeaLevelAdapter, noaaSeaLevelTrendMillimetresPerYear, NOAA_BATTERY_STATION_ID, NOAA_BATTERY_STATION_NAME, NOAA_COOPS_API_BASE, NOAA_SEA_LEVEL_APPLICATION_ID, NOAA_SEA_LEVEL_DATUM, NOAA_SEA_LEVEL_FIRST_YEAR, NOAA_SEA_LEVEL_PRODUCT, NOAA_SEA_LEVEL_UNITS, parseNoaaSeaLevelPayload, } from './noaaSeaLevel';
+/** The uniform adapter registry and probe helpers. */
+export { US_DATA_SOURCES, getUsDataSource, probeAllUsDataSources, probeUsDataSource, } from './registry.js';
+/** US Treasury average interest rate on the debt outstanding (keyless). */
+export { buildTreasuryAvgInterestRateSeries, buildTreasuryAvgInterestRateUrl, fetchTreasuryAvgInterestRates, parseTreasuryAvgInterestRatePayload, treasuryAvgInterestRateAdapter, TREASURY_AVG_INTEREST_RATE_FIRST_YEAR, TREASURY_AVG_INTEREST_RATE_PATH, TREASURY_AVG_INTEREST_RATE_ROW_LIMIT, TREASURY_AVG_INTEREST_RATE_SECURITY_DESCRIPTION, TREASURY_AVG_INTEREST_RATE_SECURITY_TYPE, TREASURY_FISCAL_DATA_API_BASE, } from './treasuryAvgInterestRate.js';
+/** FEMA disaster declarations (keyless). */
+export { buildFemaDeclarationCatalogue, buildFemaDeclarationUrl, femaDisasterDeclarationsAdapter, fetchFemaDeclarations, FEMA_DECLARATION_PATH, FEMA_DECLARATION_ROW_LIMIT, FEMA_FIRE_INCIDENT_TYPE, FEMA_OPEN_DATA_API_BASE, parseFemaDeclarationPayload, } from './femaDisasterDeclarations.js';
+/** openFDA food enforcement reports (keyless). */
+export { buildOpenFdaFoodRecallCountUrl, buildOpenFdaFoodRecallSummary, buildOpenFdaFoodRecallTotalUrl, fetchOpenFdaFoodRecalls, openFdaFoodRecallsAdapter, openFdaReportDateLabel, OPENFDA_CLASSIFICATION_COUNT_FIELD, OPENFDA_CLASS_ONE, OPENFDA_FOOD_ENFORCEMENT_BASE, OPENFDA_MANDATED_TERM, OPENFDA_REPORT_DATE_FIELD, OPENFDA_VOLUNTARY_COUNT_FIELD, OPENFDA_VOLUNTARY_TERM, parseOpenFdaFoodRecallSnapshot, parseOpenFdaRecallCounts, parseOpenFdaRecallDateCounts, parseOpenFdaRecallTotal, } from './openFdaFoodRecalls.js';
+/** USGS annual peak streamflow at a gauge (keyless). */
+export { buildUsgsPeakStreamflowSeries, buildUsgsPeakStreamflowUrl, fetchUsgsPeakStreamflow, parseUsgsPeakStreamflowPayload, USGS_DISCHARGE_PARAMETER_CODE, USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID, USGS_MISSISSIPPI_ST_LOUIS_LOCATION_NAME, USGS_PEAK_STREAMFLOW_COLLECTION, USGS_PEAK_STREAMFLOW_FIRST_WATER_YEAR, USGS_PEAK_STREAMFLOW_ROW_LIMIT, USGS_WATER_DATA_API_BASE, usgsPeakStreamflowAdapter, } from './usgsPeakStreamflow.js';
+/** CPSC consumer product recalls (keyless). */
+export { buildCpscProductRecallSeries, buildCpscRecallUrl, CPSC_ERROR_RECALL_ID, CPSC_RECALL_API_BASE, CPSC_RECALL_FIRST_YEAR, cpscProductRecallsAdapter, fetchCpscProductRecalls, parseCpscRecallPayload, parseCpscRecallSnapshot, } from './cpscProductRecalls.js';
+/** CFPB Consumer Complaint Database (keyless). */
+export { buildCfpComplaintAggregationUrl, buildCfpComplaintCountUrl, buildCfpComplaintDayUrl, buildCfpConsumerComplaintSeries, CFPB_COMPLAINT_FIRST_YEAR, CFPB_COMPLAINT_SEARCH_API_BASE, CFPB_NEWEST_DATE_PROBE_DAYS, CFPB_TOP_LIST_LIMIT, cfpbConsumerComplaintsAdapter, fetchCfpConsumerComplaints, findNewestCfpComplaintDate, parseCfpComplaintAggregations, parseCfpComplaintSnapshot, parseCfpComplaintTotal, } from './cfpbConsumerComplaints.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/nceiAnnualTemperature.d.ts

@@ -0,0 +1,92 @@
+import type { UsDataAdapter } from './types.js';
+/** One calendar year of the contiguous United States temperature record. */
+export interface NceiTemperatureYear {
+    /** The calendar year the average covers. */
+    year: number;
+    /** Mean temperature over the year, in degrees Fahrenheit. */
+    valueFahrenheit: number;
+}
+/** The annual record, with the points a story leans on. */
+export interface NceiTemperatureSeries {
+    /** Every year in the record, oldest first. */
+    years: NceiTemperatureYear[];
+    yearCount: number;
+    firstYear: number;
+    lastYear: number;
+    /** The warmest year in the record. */
+    warmest: NceiTemperatureYear;
+    /** The coldest year in the record. */
+    coldest: NceiTemperatureYear;
+    /** Mean of every year in the record, in degrees Fahrenheit. */
+    meanFahrenheit: number;
+}
+/** The window, in years, that one request reads. */
+export interface NceiTemperatureQuery {
+    /** First year in the window. */
+    startYear: number;
+    /** Last year in the window. A calendar year needs a full December first. */
+    endYear: number;
+}
+/** Climate at a Glance region id for the contiguous United States. */
+export declare const NCEI_CONTIGUOUS_US_REGION_ID = "110";
+/** Climate at a Glance parameter id for average temperature. */
+export declare const NCEI_AVERAGE_TEMPERATURE_PARAMETER_ID = "tavg";
+/**
+ * Months in the averaging window.
+ *
+ * Climate at a Glance labels a window by its length and by the month it ends
+ * on. Twelve months ending in December is the calendar year, which is the
+ * number a story about a year can compare.
+ */
+export declare const NCEI_ANNUAL_WINDOW_MONTHS = 12;
+/** Base URL for the Climate at a Glance time series download. */
+export declare const NCEI_CLIMATE_AT_A_GLANCE_BASE = "https://www.ncei.noaa.gov/access/monitoring/climate-at-a-glance";
+/** First year in the contiguous United States record the agency publishes. */
+export declare const NCEI_FIRST_RECORD_YEAR = 1895;
+/**
+ * Builds the URL for the annual temperature series.
+ *
+ * The download is keyless and public domain. One request covers the whole
+ * window: the file is one row per year, so two centuries cost about 20 KB.
+ *
+ * @param query - the first and last year to read
+ * @returns the full CSV URL
+ */
+export declare function buildNceiAnnualTemperatureUrl(query: NceiTemperatureQuery): string;
+/**
+ * Parses the Climate at a Glance CSV into one entry per calendar year.
+ *
+ * The file opens with two comment lines and a header, then carries one row
+ * per year as `YYYYMM,value`, where the month is always December because the
+ * window is the calendar year. Anything else is treated as a changed shape
+ * and stops the parse rather than being dropped in silence.
+ *
+ * @param csv - the response body from the Climate at a Glance download
+ * @returns the years in the file, oldest first
+ */
+export declare function parseNceiAnnualTemperatureCsv(csv: string): NceiTemperatureYear[];
+/**
+ * Folds the parsed years into one series with its headline years.
+ *
+ * @param years - the years in the file
+ * @returns the same years, oldest first, plus the warmest, the coldest, and the mean
+ */
+export declare function buildNceiAnnualTemperatureSeries(years: NceiTemperatureYear[]): NceiTemperatureSeries;
+/**
+ * Reads the annual temperature series from NOAA NCEI.
+ *
+ * The window defaults to the whole record. The current year joins the file
+ * once December has closed it, so the newest row is the last complete
+ * calendar year rather than a partial one.
+ *
+ * @param options - an optional window and fetch stub
+ * @returns the years in the window, oldest first, with the headline years
+ */
+export declare function fetchNceiAnnualTemperature(options?: {
+    startYear?: number;
+    endYear?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NceiTemperatureSeries>;
+/** NOAA NCEI contiguous United States annual average temperature, keyless. */
+export declare const nceiAnnualTemperatureAdapter: UsDataAdapter<NceiTemperatureSeries>;
+//# sourceMappingURL=nceiAnnualTemperature.d.ts.map

package/dist/nceiAnnualTemperature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nceiAnnualTemperature.d.ts","sourceRoot":"","sources":["../src/nceiAnnualTemperature.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,sCAAsC;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD,gEAAgE;AAChE,eAAO,MAAM,qCAAqC,SAAS,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,iEAAiE;AACjE,eAAO,MAAM,6BAA6B,oEACyB,CAAC;AAEpE,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAW3C;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAOjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAuChF;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,mBAAmB,EAAE,GAC3B,qBAAqB,CA8BvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWjC;AAED,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC,qBAAqB,CAoB7E,CAAC"}

package/dist/nceiAnnualTemperature.js

@@ -0,0 +1,158 @@
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureText } from './fixtures.js';
+/** Climate at a Glance region id for the contiguous United States. */
+export const NCEI_CONTIGUOUS_US_REGION_ID = '110';
+/** Climate at a Glance parameter id for average temperature. */
+export const NCEI_AVERAGE_TEMPERATURE_PARAMETER_ID = 'tavg';
+/**
+ * Months in the averaging window.
+ *
+ * Climate at a Glance labels a window by its length and by the month it ends
+ * on. Twelve months ending in December is the calendar year, which is the
+ * number a story about a year can compare.
+ */
+export const NCEI_ANNUAL_WINDOW_MONTHS = 12;
+/** Base URL for the Climate at a Glance time series download. */
+export const NCEI_CLIMATE_AT_A_GLANCE_BASE = 'https://www.ncei.noaa.gov/access/monitoring/climate-at-a-glance';
+/** First year in the contiguous United States record the agency publishes. */
+export const NCEI_FIRST_RECORD_YEAR = 1895;
+/** The month an annual row is stamped with: December closes the year. */
+const NCEI_ANNUAL_ROW_MONTH = '12';
+/** One data row of the CSV: a four digit year, a two digit month, a value. */
+const NCEI_DATA_ROW_PATTERN = /^(\d{4})(\d{2}),(.+)$/;
+/** Committed snapshot, so a build works when the agency host is unreachable. */
+const NCEI_FIXTURE_FILENAME = 'ncei-annual-temperature-2026-09-26.csv';
+/**
+ * Builds the URL for the annual temperature series.
+ *
+ * The download is keyless and public domain. One request covers the whole
+ * window: the file is one row per year, so two centuries cost about 20 KB.
+ *
+ * @param query - the first and last year to read
+ * @returns the full CSV URL
+ */
+export function buildNceiAnnualTemperatureUrl(query) {
+    const { startYear, endYear } = query;
+    return (`${NCEI_CLIMATE_AT_A_GLANCE_BASE}/national/time-series/${NCEI_CONTIGUOUS_US_REGION_ID}` +
+        `/${NCEI_AVERAGE_TEMPERATURE_PARAMETER_ID}/${NCEI_ANNUAL_WINDOW_MONTHS}` +
+        `/${NCEI_ANNUAL_WINDOW_MONTHS}/${startYear}-${endYear}.csv`);
+}
+/**
+ * Parses the Climate at a Glance CSV into one entry per calendar year.
+ *
+ * The file opens with two comment lines and a header, then carries one row
+ * per year as `YYYYMM,value`, where the month is always December because the
+ * window is the calendar year. Anything else is treated as a changed shape
+ * and stops the parse rather than being dropped in silence.
+ *
+ * @param csv - the response body from the Climate at a Glance download
+ * @returns the years in the file, oldest first
+ */
+export function parseNceiAnnualTemperatureCsv(csv) {
+    const years = [];
+    const seen = new Set();
+    for (const line of csv.split('\n')) {
+        const row = line.trim();
+        if (row === '' || row.startsWith('#') || row === 'Date,Value') {
+            continue;
+        }
+        const match = NCEI_DATA_ROW_PATTERN.exec(row);
+        if (match === null) {
+            throw new UsSourceParseError('ncei', `Unreadable row in the temperature file: ${row}`);
+        }
+        const [, yearPart, monthPart, valuePart] = match;
+        if (yearPart === undefined ||
+            monthPart === undefined ||
+            valuePart === undefined ||
+            monthPart !== NCEI_ANNUAL_ROW_MONTH) {
+            throw new UsSourceParseError('ncei', `Expected one calendar year per row, got ${row}`);
+        }
+        const year = Number(yearPart);
+        if (seen.has(year)) {
+            throw new UsSourceParseError('ncei', `Two rows for ${year}`);
+        }
+        const valueFahrenheit = Number(valuePart);
+        if (!Number.isFinite(valueFahrenheit)) {
+            throw new UsSourceParseError('ncei', `Unreadable value in the temperature file: ${row}`);
+        }
+        seen.add(year);
+        years.push({ year, valueFahrenheit });
+    }
+    if (years.length === 0) {
+        throw new UsSourceParseError('ncei', 'No annual rows in the response');
+    }
+    return years.sort((left, right) => left.year - right.year);
+}
+/**
+ * Folds the parsed years into one series with its headline years.
+ *
+ * @param years - the years in the file
+ * @returns the same years, oldest first, plus the warmest, the coldest, and the mean
+ */
+export function buildNceiAnnualTemperatureSeries(years) {
+    const sorted = [...years].sort((left, right) => left.year - right.year);
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    if (first === undefined || last === undefined) {
+        throw new UsSourceParseError('ncei', 'No years to summarise');
+    }
+    let warmest = first;
+    let coldest = first;
+    let total = 0;
+    for (const row of sorted) {
+        total += row.valueFahrenheit;
+        if (row.valueFahrenheit > warmest.valueFahrenheit) {
+            warmest = row;
+        }
+        if (row.valueFahrenheit < coldest.valueFahrenheit) {
+            coldest = row;
+        }
+    }
+    return {
+        years: sorted,
+        yearCount: sorted.length,
+        firstYear: first.year,
+        lastYear: last.year,
+        warmest,
+        coldest,
+        meanFahrenheit: total / sorted.length,
+    };
+}
+/**
+ * Reads the annual temperature series from NOAA NCEI.
+ *
+ * The window defaults to the whole record. The current year joins the file
+ * once December has closed it, so the newest row is the last complete
+ * calendar year rather than a partial one.
+ *
+ * @param options - an optional window and fetch stub
+ * @returns the years in the window, oldest first, with the headline years
+ */
+export async function fetchNceiAnnualTemperature(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildNceiAnnualTemperatureUrl({
+        startYear: options?.startYear ?? NCEI_FIRST_RECORD_YEAR,
+        endYear: options?.endYear ?? new Date().getFullYear(),
+    });
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError('ncei', `HTTP ${response.status} reading the temperature series`);
+    }
+    return buildNceiAnnualTemperatureSeries(parseNceiAnnualTemperatureCsv(await response.text()));
+}
+/** NOAA NCEI contiguous United States annual average temperature, keyless. */
+export const nceiAnnualTemperatureAdapter = {
+    id: 'ncei-annual-temperature',
+    name: 'NOAA NCEI contiguous US annual temperature',
+    auth: 'none',
+    description: 'Calendar-year average temperature for the contiguous United States since 1895, from the NOAA National Centers for Environmental Information.',
+    fetchLive: async (options) => fetchNceiAnnualTemperature(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => {
+        if (typeof payload !== 'string') {
+            throw new UsSourceParseError('ncei', 'The temperature download is CSV text, not JSON');
+        }
+        return buildNceiAnnualTemperatureSeries(parseNceiAnnualTemperatureCsv(payload));
+    },
+    loadFixture: () => buildNceiAnnualTemperatureSeries(parseNceiAnnualTemperatureCsv(readFixtureText(NCEI_FIXTURE_FILENAME))),
+};
+//# sourceMappingURL=nceiAnnualTemperature.js.map

package/dist/nceiAnnualTemperature.js.map

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