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

package/dist/treasuryAvgInterestRate.js

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Base URL for the Treasury Fiscal Data API. */
+export const TREASURY_FISCAL_DATA_API_BASE = 'https://api.fiscaldata.treasury.gov/services/api/fiscal_service';
+/** Dataset path for the average interest rates on Treasury securities. */
+export const TREASURY_AVG_INTEREST_RATE_PATH = '/v2/accounting/od/avg_interest_rates';
+/**
+ * Security type the adapter reads.
+ *
+ * "Interest-bearing Debt" holds the portfolio totals, the same rows the
+ * bureau's monthly statement is built from, rather than the rates on the
+ * bills, notes, and bonds issued today.
+ */
+export const TREASURY_AVG_INTEREST_RATE_SECURITY_TYPE = 'Interest-bearing Debt';
+/** Security description that carries the whole portfolio's average rate. */
+export const TREASURY_AVG_INTEREST_RATE_SECURITY_DESCRIPTION = 'Total Interest-bearing Debt';
+/** First year the dataset covers. */
+export const TREASURY_AVG_INTEREST_RATE_FIRST_YEAR = 2001;
+/**
+ * Row cap for one request.
+ *
+ * The API returns at most 10,000 rows a page and the series is around 300
+ * rows, so one request covers the whole run and the adapter never pages.
+ */
+export const TREASURY_AVG_INTEREST_RATE_ROW_LIMIT = 10_000;
+/** Columns the adapter asks for. The dataset carries a date breakdown too. */
+const TREASURY_AVG_INTEREST_RATE_COLUMNS = 'record_date,security_type_desc,security_desc,avg_interest_rate_amt';
+/** Committed snapshot, so a build works when the Treasury host is unreachable. */
+const TREASURY_AVG_INTEREST_RATE_FIXTURE_FILENAME = 'treasury-avg-interest-rate-2026-09-28.json';
+/** Shape of the agency's record date, e.g. "2026-08-31". */
+const ISO_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+// Every field arrives as a string, and a row the agency could not compute
+// arrives without a value. A rejected request answers with an HTTP error and
+// a body of {error, message} instead of the data.
+const TREASURY_ROW_SCHEMA = z.object({
+    record_date: z.string().optional(),
+    security_type_desc: z.string().optional(),
+    security_desc: z.string().optional(),
+    avg_interest_rate_amt: z.string().optional(),
+});
+const TREASURY_PAYLOAD_SCHEMA = z.object({
+    data: z.array(TREASURY_ROW_SCHEMA).optional(),
+    error: z.string().optional(),
+    message: z.string().optional(),
+});
+/**
+ * Builds the request URL for the whole published series.
+ *
+ * The filter pins the response to the portfolio's own total, so the rows for
+ * bills, notes, bonds, and the non-marketable debt never reach the parser.
+ * The endpoint is keyless.
+ *
+ * @param options - an optional security type and row cap
+ * @returns the full request URL
+ */
+export function buildTreasuryAvgInterestRateUrl(options) {
+    const params = new URLSearchParams({
+        fields: TREASURY_AVG_INTEREST_RATE_COLUMNS,
+        filter: `security_type_desc:eq:${options?.securityType ?? TREASURY_AVG_INTEREST_RATE_SECURITY_TYPE}`,
+        sort: 'record_date',
+        'page[size]': String(options?.rowLimit ?? TREASURY_AVG_INTEREST_RATE_ROW_LIMIT),
+    });
+    return `${TREASURY_FISCAL_DATA_API_BASE}${TREASURY_AVG_INTEREST_RATE_PATH}?${params.toString()}`;
+}
+/**
+ * Parses one response into the months that carry a rate.
+ *
+ * A row for another security type is a changed filter and stops the parse,
+ * so a response that ignored the filter cannot quietly widen the series. A
+ * row without a rate is dropped, which is how a month the agency could not
+ * compute would arrive. A row without a readable date is a changed shape and
+ * also stops the parse.
+ *
+ * @param payload - the JSON body from the Fiscal Data API
+ * @returns the months that carry a rate, in the order the agency sent them
+ */
+export function parseTreasuryAvgInterestRatePayload(payload) {
+    const parsed = TREASURY_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('treasury', parsed.error.message);
+    }
+    if (parsed.data.error !== undefined) {
+        throw new UsSourceApiError('treasury', parsed.data.message ?? `The API rejected the request: ${parsed.data.error}`);
+    }
+    const rows = parsed.data.data ?? [];
+    if (rows.length === 0) {
+        throw new UsSourceParseError('treasury', 'The response carried no rows');
+    }
+    const months = [];
+    for (const row of rows) {
+        if (row.security_type_desc !== undefined &&
+            row.security_type_desc !== TREASURY_AVG_INTEREST_RATE_SECURITY_TYPE) {
+            throw new UsSourceParseError('treasury', `Unexpected security type in the response: ${row.security_type_desc}`);
+        }
+        if (row.security_desc !== undefined &&
+            row.security_desc !== TREASURY_AVG_INTEREST_RATE_SECURITY_DESCRIPTION) {
+            throw new UsSourceParseError('treasury', `Unexpected security in the response: ${row.security_desc}`);
+        }
+        if (row.record_date === undefined) {
+            throw new UsSourceParseError('treasury', 'A row carries no record date');
+        }
+        const match = ISO_DATE_PATTERN.exec(row.record_date);
+        if (match === null) {
+            throw new UsSourceParseError('treasury', `Unreadable record date: ${row.record_date}`);
+        }
+        if (row.avg_interest_rate_amt === undefined || row.avg_interest_rate_amt.trim() === '') {
+            continue;
+        }
+        const averageInterestRatePercent = Number(row.avg_interest_rate_amt);
+        if (!Number.isFinite(averageInterestRatePercent)) {
+            throw new UsSourceParseError('treasury', `Unreadable average interest rate: ${row.avg_interest_rate_amt}`);
+        }
+        months.push({
+            recordDate: row.record_date,
+            year: Number(match[1]),
+            month: Number(match[2]),
+            averageInterestRatePercent,
+        });
+    }
+    if (months.length === 0) {
+        throw new UsSourceParseError('treasury', 'No monthly values in the response');
+    }
+    return months;
+}
+/**
+ * Folds the parsed months into one series with the headline months named.
+ *
+ * The months are sorted oldest first, so a caller reading index 0 gets the
+ * start of the run and index -1 gets the newest month.
+ *
+ * @param months - the parsed months, in any order
+ * @returns the sorted months, the highest and lowest in the run, and the change
+ */
+export function buildTreasuryAvgInterestRateSeries(months) {
+    const sorted = [...months].sort((left, right) => left.recordDate.localeCompare(right.recordDate));
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    if (first === undefined || last === undefined) {
+        throw new UsSourceParseError('treasury', 'No months to summarise');
+    }
+    let highest = first;
+    let lowest = first;
+    for (const month of sorted) {
+        if (month.averageInterestRatePercent > highest.averageInterestRatePercent) {
+            highest = month;
+        }
+        if (month.averageInterestRatePercent < lowest.averageInterestRatePercent) {
+            lowest = month;
+        }
+    }
+    return {
+        months: sorted,
+        monthCount: sorted.length,
+        firstMonth: first,
+        lastMonth: last,
+        highest,
+        lowest,
+        changeSinceLowPercentPoints: last.averageInterestRatePercent - lowest.averageInterestRatePercent,
+        changeFirstToLastPercentPoints: last.averageInterestRatePercent - first.averageInterestRatePercent,
+    };
+}
+/**
+ * Reads the average interest rate on the Treasury's interest-bearing debt.
+ *
+ * One keyless request covers the whole published run, which starts in
+ * January 2001 and answers one row per month.
+ *
+ * @param options - an optional security type and fetch stub
+ * @returns the monthly rates, the highest and lowest months, and the change
+ */
+export async function fetchTreasuryAvgInterestRates(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildTreasuryAvgInterestRateUrl(options?.securityType === undefined ? {} : { securityType: options.securityType });
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError('treasury', `HTTP ${response.status} reading the average interest rates`);
+    }
+    return buildTreasuryAvgInterestRateSeries(parseTreasuryAvgInterestRatePayload(await response.json()));
+}
+/** US Treasury average interest rate on the debt outstanding, keyless. */
+export const treasuryAvgInterestRateAdapter = {
+    id: 'treasury-avg-interest-rate',
+    name: 'US Treasury average interest rate',
+    auth: 'none',
+    description: 'Average interest rate on the interest-bearing US Treasury debt outstanding, one row per month since 2001.',
+    fetchLive: async (options) => fetchTreasuryAvgInterestRates(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => buildTreasuryAvgInterestRateSeries(parseTreasuryAvgInterestRatePayload(payload)),
+    loadFixture: () => buildTreasuryAvgInterestRateSeries(parseTreasuryAvgInterestRatePayload(readFixtureJson(TREASURY_AVG_INTEREST_RATE_FIXTURE_FILENAME))),
+};
+//# sourceMappingURL=treasuryAvgInterestRate.js.map

package/dist/treasuryAvgInterestRate.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+/** What a US source needs before it will answer a request. */
+export type UsSourceAuth = 'none' | 'key';
+/** Options shared by every adapter's live fetch. */
+export interface UsFetchOptions {
+    apiKey?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}
+/**
+ * One US data source behind a uniform interface: a live fetch, a strict
+ * parse, and a committed fixture fallback so builds work offline.
+ */
+export interface UsDataAdapter<T> {
+    readonly id: string;
+    readonly name: string;
+    readonly auth: UsSourceAuth;
+    readonly description: string;
+    fetchLive(options?: UsFetchOptions): Promise<T>;
+    parse(payload: unknown): T;
+    loadFixture(): T;
+}
+/** Result of a live verification probe against one source. */
+export interface UsSourceProbe {
+    id: string;
+    name: string;
+    auth: UsSourceAuth;
+    ok: boolean;
+    status: string;
+    sample?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1C,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC;IAC3B,WAAW,IAAI,CAAC,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/usgsEarthquakes.d.ts

@@ -0,0 +1,108 @@
+import type { UsDataAdapter } from './types.js';
+/** One earthquake, as the USGS catalogue reports it. */
+export interface UsgsEarthquake {
+    id: string;
+    magnitude: number;
+    /** Free-text place, such as "5 km S of Pāhala, Hawaii". */
+    place: string;
+    /** Origin time in milliseconds since the epoch. */
+    timeMs: number;
+    depthKm: number;
+    /** The agency's own event page for this earthquake. */
+    url: string;
+}
+/** A set of earthquakes with the points a story leans on. */
+export interface UsgsEarthquakeCatalogue {
+    earthquakes: UsgsEarthquake[];
+    count: number;
+    strongest: UsgsEarthquake;
+    deepest: UsgsEarthquake;
+    earliest: UsgsEarthquake;
+    latest: UsgsEarthquake;
+}
+/** The latitude and longitude box a catalogue query filters on. */
+export interface UsgsEarthquakeBounds {
+    minLatitude: number;
+    maxLatitude: number;
+    minLongitude: number;
+    maxLongitude: number;
+}
+/** The window, magnitude floor, and box one catalogue query reads. */
+export interface UsgsEarthquakeQuery {
+    /** Start of the window, as YYYY-MM-DD. */
+    startDate: string;
+    /** End of the window, as YYYY-MM-DD. The catalogue excludes the end date. */
+    endDate: string;
+    minMagnitude: number;
+    bounds: UsgsEarthquakeBounds;
+}
+/** Base URL for the USGS earthquake catalogue (FDSN event query). */
+export declare const USGS_EARTHQUAKE_API_BASE = "https://earthquake.usgs.gov/fdsnws/event/1/query";
+/** The box the Hawaii adapter reads: the main Hawaiian islands and the water around them. */
+export declare const USGS_HAWAII_BOUNDS: UsgsEarthquakeBounds;
+/** Magnitude floor for the Hawaii adapter. */
+export declare const USGS_HAWAII_MIN_MAGNITUDE = 2.5;
+/** Days the Hawaii adapter's rolling window covers. */
+export declare const USGS_ROLLING_WINDOW_DAYS = 365;
+/**
+ * Builds the catalogue query URL for one window.
+ *
+ * The catalogue is keyless and public domain. The query asks for GeoJSON,
+ * ordered oldest first is left to the parser, and the box and magnitude floor
+ * come from the caller.
+ *
+ * @param query - the window, magnitude floor, and box to read
+ * @returns the full query URL
+ */
+export declare function buildUsgsEarthquakeUrl(query: UsgsEarthquakeQuery): string;
+/**
+ * Parses a catalogue response into earthquakes, oldest first.
+ *
+ * The catalogue holds more than tectonic earthquakes: quarry blasts,
+ * explosions, and ice quakes sit in the same feed, and a row can arrive with
+ * no magnitude. Both are dropped, so every record here is an earthquake with
+ * a magnitude and a depth.
+ *
+ * @param payload - the GeoJSON body from the event query endpoint
+ * @returns the earthquakes in the window, oldest first
+ */
+export declare function parseUsgsEarthquakes(payload: unknown): UsgsEarthquake[];
+/**
+ * Sorts earthquakes oldest first, with the event id breaking a tie. The
+ * catalogue answers newest first, and a caller reading `earthquakes[0]`
+ * should get the start of the window.
+ *
+ * @param earthquakes - earthquakes in any order
+ * @returns the same earthquakes, oldest first
+ */
+export declare function sortEarthquakesOldestFirst(earthquakes: UsgsEarthquake[]): UsgsEarthquake[];
+/**
+ * Folds earthquakes into one catalogue with its headline points.
+ *
+ * @param earthquakes - earthquakes in any order
+ * @returns the catalogue, ordered oldest first, plus the strongest and deepest
+ */
+export declare function buildUsgsEarthquakeCatalogue(earthquakes: UsgsEarthquake[]): UsgsEarthquakeCatalogue;
+/**
+ * Reads one window of the catalogue.
+ *
+ * Keyless. The catalogue answers a window of any length, so a caller can ask
+ * for a single year or for the whole record.
+ *
+ * @param query - the window, magnitude floor, and box to read
+ * @param options - an optional fetch stub
+ * @returns every earthquake in the window, oldest first
+ */
+export declare function fetchUsgsEarthquakes(query: UsgsEarthquakeQuery, options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<UsgsEarthquake[]>;
+/**
+ * The window the Hawaii adapter reads by default: the last 365 days, up to today.
+ *
+ * @param now - the day to count back from, for tests
+ * @returns the rolling window, in the plain dates the catalogue wants
+ */
+export declare function usgsHawaiiRollingWindow(now?: Date): UsgsEarthquakeQuery;
+/** Earthquakes near Hawaii, magnitude 2.5 and above, keyless. */
+export declare const usgsHawaiiEarthquakesAdapter: UsDataAdapter<UsgsEarthquakeCatalogue>;
+//# sourceMappingURL=usgsEarthquakes.d.ts.map

package/dist/usgsEarthquakes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usgsEarthquakes.d.ts","sourceRoot":"","sources":["../src/usgsEarthquakes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,qDAAqD,CAAC;AAE3F,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,EAAE,oBAKhC,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AA8B5C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAazE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,CA8BvE;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAO1F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,cAAc,EAAE,GAC5B,uBAAuB,CA2BzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAE,GAChD,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,IAAiB,GAAG,mBAAmB,CASnF;AAED,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC,uBAAuB,CAgB/E,CAAC"}

package/dist/usgsEarthquakes.js

@@ -0,0 +1,199 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Base URL for the USGS earthquake catalogue (FDSN event query). */
+export const USGS_EARTHQUAKE_API_BASE = 'https://earthquake.usgs.gov/fdsnws/event/1/query';
+/** The box the Hawaii adapter reads: the main Hawaiian islands and the water around them. */
+export const USGS_HAWAII_BOUNDS = {
+    minLatitude: 18.5,
+    maxLatitude: 22.5,
+    minLongitude: -161,
+    maxLongitude: -154,
+};
+/** Magnitude floor for the Hawaii adapter. */
+export const USGS_HAWAII_MIN_MAGNITUDE = 2.5;
+/** Days the Hawaii adapter's rolling window covers. */
+export const USGS_ROLLING_WINDOW_DAYS = 365;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+const USGS_FEATURE_SCHEMA = z.object({
+    id: z.string(),
+    properties: z.object({
+        mag: z.number().nullable(),
+        place: z.string().nullable(),
+        time: z.number(),
+        url: z.string(),
+        type: z.string(),
+    }),
+    geometry: z.object({
+        coordinates: z.array(z.number()).min(2),
+    }),
+});
+const USGS_RESPONSE_SCHEMA = z.object({
+    type: z.literal('FeatureCollection'),
+    metadata: z.object({
+        status: z.number(),
+        count: z.number().optional(),
+    }),
+    features: z.array(USGS_FEATURE_SCHEMA),
+});
+/** The catalogue's own label for a tectonic earthquake. */
+const USGS_EARTHQUAKE_TYPE = 'earthquake';
+/**
+ * Builds the catalogue query URL for one window.
+ *
+ * The catalogue is keyless and public domain. The query asks for GeoJSON,
+ * ordered oldest first is left to the parser, and the box and magnitude floor
+ * come from the caller.
+ *
+ * @param query - the window, magnitude floor, and box to read
+ * @returns the full query URL
+ */
+export function buildUsgsEarthquakeUrl(query) {
+    const params = new URLSearchParams({
+        format: 'geojson',
+        starttime: query.startDate,
+        endtime: query.endDate,
+        minmagnitude: String(query.minMagnitude),
+        minlatitude: String(query.bounds.minLatitude),
+        maxlatitude: String(query.bounds.maxLatitude),
+        minlongitude: String(query.bounds.minLongitude),
+        maxlongitude: String(query.bounds.maxLongitude),
+        orderby: 'time',
+    });
+    return `${USGS_EARTHQUAKE_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses a catalogue response into earthquakes, oldest first.
+ *
+ * The catalogue holds more than tectonic earthquakes: quarry blasts,
+ * explosions, and ice quakes sit in the same feed, and a row can arrive with
+ * no magnitude. Both are dropped, so every record here is an earthquake with
+ * a magnitude and a depth.
+ *
+ * @param payload - the GeoJSON body from the event query endpoint
+ * @returns the earthquakes in the window, oldest first
+ */
+export function parseUsgsEarthquakes(payload) {
+    const parsed = USGS_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('usgs', parsed.error.message);
+    }
+    if (parsed.data.metadata.status !== 200) {
+        throw new UsSourceApiError('usgs', `catalogue status ${parsed.data.metadata.status}`);
+    }
+    const earthquakes = [];
+    for (const feature of parsed.data.features) {
+        const { mag, place, time, url, type } = feature.properties;
+        if (type !== USGS_EARTHQUAKE_TYPE || mag === null || place === null) {
+            continue;
+        }
+        const depthKm = feature.geometry.coordinates[2];
+        if (typeof depthKm !== 'number' || !Number.isFinite(depthKm) || !Number.isFinite(time)) {
+            continue;
+        }
+        earthquakes.push({
+            id: feature.id,
+            magnitude: mag,
+            place,
+            timeMs: time,
+            depthKm,
+            url,
+        });
+    }
+    return sortEarthquakesOldestFirst(earthquakes);
+}
+/**
+ * Sorts earthquakes oldest first, with the event id breaking a tie. The
+ * catalogue answers newest first, and a caller reading `earthquakes[0]`
+ * should get the start of the window.
+ *
+ * @param earthquakes - earthquakes in any order
+ * @returns the same earthquakes, oldest first
+ */
+export function sortEarthquakesOldestFirst(earthquakes) {
+    return [...earthquakes].sort((left, right) => {
+        if (left.timeMs !== right.timeMs) {
+            return left.timeMs - right.timeMs;
+        }
+        return left.id.localeCompare(right.id);
+    });
+}
+/**
+ * Folds earthquakes into one catalogue with its headline points.
+ *
+ * @param earthquakes - earthquakes in any order
+ * @returns the catalogue, ordered oldest first, plus the strongest and deepest
+ */
+export function buildUsgsEarthquakeCatalogue(earthquakes) {
+    const ordered = sortEarthquakesOldestFirst(earthquakes);
+    const earliest = ordered[0];
+    const latest = ordered[ordered.length - 1];
+    if (earliest === undefined || latest === undefined) {
+        throw new UsSourceParseError('usgs', 'No earthquakes in the catalogue');
+    }
+    let strongest = earliest;
+    let deepest = earliest;
+    for (const earthquake of ordered) {
+        if (earthquake.magnitude > strongest.magnitude) {
+            strongest = earthquake;
+        }
+        if (earthquake.depthKm > deepest.depthKm) {
+            deepest = earthquake;
+        }
+    }
+    return {
+        earthquakes: ordered,
+        count: ordered.length,
+        strongest,
+        deepest,
+        earliest,
+        latest,
+    };
+}
+/**
+ * Reads one window of the catalogue.
+ *
+ * Keyless. The catalogue answers a window of any length, so a caller can ask
+ * for a single year or for the whole record.
+ *
+ * @param query - the window, magnitude floor, and box to read
+ * @param options - an optional fetch stub
+ * @returns every earthquake in the window, oldest first
+ */
+export async function fetchUsgsEarthquakes(query, options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const response = await fetchImpl(buildUsgsEarthquakeUrl(query));
+    if (!response.ok) {
+        throw new UsSourceApiError('usgs', `HTTP ${response.status} reading the catalogue`);
+    }
+    return parseUsgsEarthquakes(await response.json());
+}
+/**
+ * The window the Hawaii adapter reads by default: the last 365 days, up to today.
+ *
+ * @param now - the day to count back from, for tests
+ * @returns the rolling window, in the plain dates the catalogue wants
+ */
+export function usgsHawaiiRollingWindow(now = new Date()) {
+    return {
+        startDate: new Date(now.getTime() - USGS_ROLLING_WINDOW_DAYS * MS_PER_DAY)
+            .toISOString()
+            .slice(0, 10),
+        endDate: now.toISOString().slice(0, 10),
+        minMagnitude: USGS_HAWAII_MIN_MAGNITUDE,
+        bounds: USGS_HAWAII_BOUNDS,
+    };
+}
+/** Earthquakes near Hawaii, magnitude 2.5 and above, keyless. */
+export const usgsHawaiiEarthquakesAdapter = {
+    id: 'usgs-hawaii-earthquakes',
+    name: 'USGS earthquakes around Hawaii',
+    auth: 'none',
+    description: 'Earthquakes of magnitude 2.5 and above near the Hawaiian islands.',
+    fetchLive: async (options) => buildUsgsEarthquakeCatalogue(await fetchUsgsEarthquakes(usgsHawaiiRollingWindow(), {
+        ...(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    })),
+    parse: (payload) => buildUsgsEarthquakeCatalogue(parseUsgsEarthquakes(payload)),
+    loadFixture: () => buildUsgsEarthquakeCatalogue(parseUsgsEarthquakes(readFixtureJson('usgs-hawaii-earthquakes.json'))),
+};
+//# sourceMappingURL=usgsEarthquakes.js.map

package/dist/usgsEarthquakes.js.map

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