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

package/dist/usgsPeakStreamflow.d.ts

@@ -0,0 +1,116 @@
+import type { UsDataAdapter } from './types.js';
+/** One water year's peak flow at a river gauge. */
+export interface UsgsPeakStreamflowYear {
+    /** Water year the agency files the peak under. A water year starts in October. */
+    waterYear: number;
+    /** Calendar year the peak fell in, which can differ from the water year. */
+    calendarYear: number;
+    /** Date of the peak day, e.g. "1993-08-01". */
+    peakDate: string;
+    /** Peak discharge that day, in cubic feet per second. */
+    peakDischargeCubicFeetPerSecond: number;
+    /**
+     * The agency's own qualifiers for the record, e.g. "REGULATED" when a dam
+     * controls the river or "MAXDAILYMEAN" when the peak is a daily mean rather
+     * than an instantaneous reading. Empty when the agency sent none.
+     */
+    qualifiers: string[];
+}
+/** One gauge's peak-flow record, folded down to the points a story leans on. */
+export interface UsgsPeakStreamflowSeries {
+    /** The agency's own id for the gauge, e.g. "USGS-07010000". */
+    monitoringLocationId: string;
+    /** One entry per water year that carries a peak, oldest first. */
+    years: UsgsPeakStreamflowYear[];
+    yearCount: number;
+    firstYear: UsgsPeakStreamflowYear;
+    lastYear: UsgsPeakStreamflowYear;
+    highest: UsgsPeakStreamflowYear;
+    lowest: UsgsPeakStreamflowYear;
+    /** The middle peak, by value, across the record. */
+    median: UsgsPeakStreamflowYear;
+    /** Water years between the first and the last that carry no peak row. */
+    missingWaterYears: number[];
+    /** Highest peak divided by the lowest, rounded to one decimal. */
+    highestToLowestRatio: number;
+}
+/** Base URL for the USGS Water Data OGC API. */
+export declare const USGS_WATER_DATA_API_BASE = "https://api.waterdata.usgs.gov/ogcapi/v0";
+/** Collection holding the annual peak-flow record for every gauge. */
+export declare const USGS_PEAK_STREAMFLOW_COLLECTION = "peaks";
+/** USGS parameter code for discharge, in cubic feet per second. */
+export declare const USGS_DISCHARGE_PARAMETER_CODE = "00060";
+/** The gauge the adapter reads by default: the Mississippi River at St. Louis. */
+export declare const USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID = "USGS-07010000";
+/** Name the agency gives that gauge. */
+export declare const USGS_MISSISSIPPI_ST_LOUIS_LOCATION_NAME = "Mississippi River at St. Louis, MO";
+/** First water year on the default gauge's record. */
+export declare const USGS_PEAK_STREAMFLOW_FIRST_WATER_YEAR = 1844;
+/**
+ * Row cap for one request.
+ *
+ * The default gauge's record is 165 rows and the API answers a whole
+ * collection in one page at this cap, so the adapter never pages. A record
+ * longer than the cap would be a change worth making here rather than a
+ * silent truncation.
+ */
+export declare const USGS_PEAK_STREAMFLOW_ROW_LIMIT = 500;
+/**
+ * Builds the request URL for one gauge's annual peak-flow record.
+ *
+ * The filter pins the response to the discharge parameter, so the rows for
+ * every other parameter a gauge reports never reach the parser. The endpoint
+ * is keyless.
+ *
+ * @param options - an optional gauge id, parameter code, and row cap
+ * @returns the full request URL
+ */
+export declare function buildUsgsPeakStreamflowUrl(options?: {
+    monitoringLocationId?: string;
+    parameterCode?: string;
+    rowLimit?: number;
+}): string;
+/**
+ * Parses one response into the water years that carry a peak.
+ *
+ * A row for another gauge or another parameter is a changed filter and stops
+ * the parse, so a response that ignored the filter cannot quietly widen the
+ * series. A row without a value is dropped, which is how a year the agency
+ * could not compute would arrive. A row without a readable date or water year
+ * is a changed shape and also stops the parse.
+ *
+ * @param payload - the JSON body from the Water Data API
+ * @returns the water years that carry a peak, in the order the agency sent them
+ */
+export declare function parseUsgsPeakStreamflowPayload(payload: unknown): UsgsPeakStreamflowYear[];
+/**
+ * Folds the parsed rows into one record with the headline years named.
+ *
+ * The rows are sorted oldest first, so a caller reading index 0 gets the
+ * start of the record. A water year with no row at all is listed in
+ * `missingWaterYears` rather than drawn as a zero, because a year the agency
+ * never filed is not a year the river ran dry.
+ *
+ * @param rows - the parsed water years, in any order
+ * @param options - the gauge the rows belong to
+ * @returns the sorted record, the highest, lowest, and middle years, and the gap list
+ */
+export declare function buildUsgsPeakStreamflowSeries(rows: UsgsPeakStreamflowYear[], options?: {
+    monitoringLocationId?: string;
+}): UsgsPeakStreamflowSeries;
+/**
+ * Reads the annual peak-flow record for one gauge.
+ *
+ * One keyless request covers the whole record. The default gauge, the
+ * Mississippi River at St. Louis, answers 165 water years from 1844.
+ *
+ * @param options - an optional gauge id and fetch stub
+ * @returns the record with the highest, lowest, and middle years named
+ */
+export declare function fetchUsgsPeakStreamflow(options?: {
+    monitoringLocationId?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<UsgsPeakStreamflowSeries>;
+/** USGS annual peak streamflow at a gauge, keyless. */
+export declare const usgsPeakStreamflowAdapter: UsDataAdapter<UsgsPeakStreamflowSeries>;
+//# sourceMappingURL=usgsPeakStreamflow.d.ts.map

package/dist/usgsPeakStreamflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usgsPeakStreamflow.d.ts","sourceRoot":"","sources":["../src/usgsPeakStreamflow.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,+BAA+B,EAAE,MAAM,CAAC;IACxC;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,sBAAsB,CAAC;IAClC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,oDAAoD;IACpD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kEAAkE;IAClE,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,6CAA6C,CAAC;AAEnF,sEAAsE;AACtE,eAAO,MAAM,+BAA+B,UAAU,CAAC;AAEvD,mEAAmE;AACnE,eAAO,MAAM,6BAA6B,UAAU,CAAC;AAErD,kFAAkF;AAClF,eAAO,MAAM,qCAAqC,kBAAkB,CAAC;AAErE,wCAAwC;AACxC,eAAO,MAAM,uCAAuC,uCAAuC,CAAC;AAE5F,sDAAsD;AACtD,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AA2BlD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAOT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,EAAE,CA+DzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,sBAAsB,EAAE,EAC9B,OAAO,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,wBAAwB,CAkD1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IACtD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAoBpC;AAED,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,EAAE,aAAa,CAAC,wBAAwB,CAe7E,CAAC"}

package/dist/usgsPeakStreamflow.js

@@ -0,0 +1,211 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Base URL for the USGS Water Data OGC API. */
+export const USGS_WATER_DATA_API_BASE = 'https://api.waterdata.usgs.gov/ogcapi/v0';
+/** Collection holding the annual peak-flow record for every gauge. */
+export const USGS_PEAK_STREAMFLOW_COLLECTION = 'peaks';
+/** USGS parameter code for discharge, in cubic feet per second. */
+export const USGS_DISCHARGE_PARAMETER_CODE = '00060';
+/** The gauge the adapter reads by default: the Mississippi River at St. Louis. */
+export const USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID = 'USGS-07010000';
+/** Name the agency gives that gauge. */
+export const USGS_MISSISSIPPI_ST_LOUIS_LOCATION_NAME = 'Mississippi River at St. Louis, MO';
+/** First water year on the default gauge's record. */
+export const USGS_PEAK_STREAMFLOW_FIRST_WATER_YEAR = 1844;
+/**
+ * Row cap for one request.
+ *
+ * The default gauge's record is 165 rows and the API answers a whole
+ * collection in one page at this cap, so the adapter never pages. A record
+ * longer than the cap would be a change worth making here rather than a
+ * silent truncation.
+ */
+export const USGS_PEAK_STREAMFLOW_ROW_LIMIT = 500;
+/** Committed snapshot, so a build works when the USGS host is unreachable. */
+const USGS_PEAK_STREAMFLOW_FIXTURE_FILENAME = 'usgs-peak-streamflow-2026-10-01.json';
+/** Shape of the agency's peak date, e.g. "1993-08-01". */
+const ISO_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+// Every property arrives as a string except the date parts and the water
+// year. The API answers an OGC API feature collection, so the numbers sit
+// under `properties` rather than at the top of each row.
+const USGS_PEAK_ROW_SCHEMA = z.object({
+    monitoring_location_id: z.string().optional(),
+    parameter_code: z.string().optional(),
+    unit_of_measure: z.string().optional(),
+    value: z.string().optional(),
+    time: z.string().nullable().optional(),
+    water_year: z.number().nullable().optional(),
+    year: z.number().nullable().optional(),
+    qualifier: z.array(z.string()).nullable().optional(),
+});
+const USGS_PEAK_PAYLOAD_SCHEMA = z.object({
+    type: z.string().optional(),
+    features: z.array(z.object({ properties: USGS_PEAK_ROW_SCHEMA })).optional(),
+});
+/**
+ * Builds the request URL for one gauge's annual peak-flow record.
+ *
+ * The filter pins the response to the discharge parameter, so the rows for
+ * every other parameter a gauge reports never reach the parser. The endpoint
+ * is keyless.
+ *
+ * @param options - an optional gauge id, parameter code, and row cap
+ * @returns the full request URL
+ */
+export function buildUsgsPeakStreamflowUrl(options) {
+    const params = new URLSearchParams({
+        monitoring_location_id: options?.monitoringLocationId ?? USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID,
+        parameter_code: options?.parameterCode ?? USGS_DISCHARGE_PARAMETER_CODE,
+        limit: String(options?.rowLimit ?? USGS_PEAK_STREAMFLOW_ROW_LIMIT),
+    });
+    return `${USGS_WATER_DATA_API_BASE}/collections/${USGS_PEAK_STREAMFLOW_COLLECTION}/items?${params.toString()}`;
+}
+/**
+ * Parses one response into the water years that carry a peak.
+ *
+ * A row for another gauge or another parameter is a changed filter and stops
+ * the parse, so a response that ignored the filter cannot quietly widen the
+ * series. A row without a value is dropped, which is how a year the agency
+ * could not compute would arrive. A row without a readable date or water year
+ * is a changed shape and also stops the parse.
+ *
+ * @param payload - the JSON body from the Water Data API
+ * @returns the water years that carry a peak, in the order the agency sent them
+ */
+export function parseUsgsPeakStreamflowPayload(payload) {
+    const parsed = USGS_PEAK_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError('usgs-peak-streamflow', parsed.error.message);
+    }
+    const features = parsed.data.features ?? [];
+    if (features.length === 0) {
+        throw new UsSourceParseError('usgs-peak-streamflow', 'The response carried no rows');
+    }
+    const years = [];
+    for (const feature of features) {
+        const row = feature.properties;
+        if (row.monitoring_location_id !== undefined &&
+            row.monitoring_location_id !== USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID) {
+            throw new UsSourceParseError('usgs-peak-streamflow', `Unexpected gauge in the response: ${row.monitoring_location_id}`);
+        }
+        if (row.parameter_code !== undefined && row.parameter_code !== USGS_DISCHARGE_PARAMETER_CODE) {
+            throw new UsSourceParseError('usgs-peak-streamflow', `Unexpected parameter in the response: ${row.parameter_code}`);
+        }
+        if (row.value === undefined || row.value.trim() === '') {
+            continue;
+        }
+        const peakDischargeCubicFeetPerSecond = Number(row.value);
+        if (!Number.isFinite(peakDischargeCubicFeetPerSecond)) {
+            throw new UsSourceParseError('usgs-peak-streamflow', `Unreadable peak discharge: ${row.value}`);
+        }
+        if (row.time === undefined || row.time === null) {
+            throw new UsSourceParseError('usgs-peak-streamflow', 'A row carries no peak date');
+        }
+        const match = ISO_DATE_PATTERN.exec(row.time);
+        if (match === null) {
+            throw new UsSourceParseError('usgs-peak-streamflow', `Unreadable peak date: ${row.time}`);
+        }
+        if (row.water_year === undefined || row.water_year === null) {
+            throw new UsSourceParseError('usgs-peak-streamflow', `Row ${row.time} carries no water year`);
+        }
+        years.push({
+            waterYear: row.water_year,
+            calendarYear: Number(match[1]),
+            peakDate: row.time,
+            peakDischargeCubicFeetPerSecond,
+            qualifiers: row.qualifier ?? [],
+        });
+    }
+    if (years.length === 0) {
+        throw new UsSourceParseError('usgs-peak-streamflow', 'No peak values in the response');
+    }
+    return years;
+}
+/**
+ * Folds the parsed rows into one record with the headline years named.
+ *
+ * The rows are sorted oldest first, so a caller reading index 0 gets the
+ * start of the record. A water year with no row at all is listed in
+ * `missingWaterYears` rather than drawn as a zero, because a year the agency
+ * never filed is not a year the river ran dry.
+ *
+ * @param rows - the parsed water years, in any order
+ * @param options - the gauge the rows belong to
+ * @returns the sorted record, the highest, lowest, and middle years, and the gap list
+ */
+export function buildUsgsPeakStreamflowSeries(rows, options) {
+    const years = [...rows].sort((left, right) => left.waterYear - right.waterYear);
+    const first = years[0];
+    const last = years[years.length - 1];
+    if (first === undefined || last === undefined) {
+        throw new UsSourceParseError('usgs-peak-streamflow', 'No water years to summarise');
+    }
+    let highest = first;
+    let lowest = first;
+    for (const year of years) {
+        if (year.peakDischargeCubicFeetPerSecond > highest.peakDischargeCubicFeetPerSecond) {
+            highest = year;
+        }
+        if (year.peakDischargeCubicFeetPerSecond < lowest.peakDischargeCubicFeetPerSecond) {
+            lowest = year;
+        }
+    }
+    const byValue = [...years].sort((left, right) => left.peakDischargeCubicFeetPerSecond - right.peakDischargeCubicFeetPerSecond);
+    const median = byValue[Math.floor(byValue.length / 2)];
+    if (median === undefined) {
+        throw new UsSourceParseError('usgs-peak-streamflow', 'No water years to summarise');
+    }
+    const filed = new Set(years.map((year) => year.waterYear));
+    const missingWaterYears = [];
+    for (let waterYear = first.waterYear; waterYear <= last.waterYear; waterYear += 1) {
+        if (!filed.has(waterYear)) {
+            missingWaterYears.push(waterYear);
+        }
+    }
+    return {
+        monitoringLocationId: options?.monitoringLocationId ?? USGS_MISSISSIPPI_ST_LOUIS_LOCATION_ID,
+        years,
+        yearCount: years.length,
+        firstYear: first,
+        lastYear: last,
+        highest,
+        lowest,
+        median,
+        missingWaterYears,
+        highestToLowestRatio: Math.round((highest.peakDischargeCubicFeetPerSecond / lowest.peakDischargeCubicFeetPerSecond) * 10) / 10,
+    };
+}
+/**
+ * Reads the annual peak-flow record for one gauge.
+ *
+ * One keyless request covers the whole record. The default gauge, the
+ * Mississippi River at St. Louis, answers 165 water years from 1844.
+ *
+ * @param options - an optional gauge id and fetch stub
+ * @returns the record with the highest, lowest, and middle years named
+ */
+export async function fetchUsgsPeakStreamflow(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildUsgsPeakStreamflowUrl(options?.monitoringLocationId === undefined
+        ? {}
+        : { monitoringLocationId: options.monitoringLocationId });
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError('usgs-peak-streamflow', `HTTP ${response.status} reading the peak-flow record`);
+    }
+    return buildUsgsPeakStreamflowSeries(parseUsgsPeakStreamflowPayload(await response.json()), options?.monitoringLocationId === undefined
+        ? {}
+        : { monitoringLocationId: options.monitoringLocationId });
+}
+/** USGS annual peak streamflow at a gauge, keyless. */
+export const usgsPeakStreamflowAdapter = {
+    id: 'usgs-peak-streamflow',
+    name: 'USGS annual peak streamflow',
+    auth: 'none',
+    description: 'The annual peak-flow record at a USGS stream gauge, one row per water year, through the USGS Water Data OGC API.',
+    fetchLive: async (options) => fetchUsgsPeakStreamflow(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => buildUsgsPeakStreamflowSeries(parseUsgsPeakStreamflowPayload(payload)),
+    loadFixture: () => buildUsgsPeakStreamflowSeries(parseUsgsPeakStreamflowPayload(readFixtureJson(USGS_PEAK_STREAMFLOW_FIXTURE_FILENAME))),
+};
+//# sourceMappingURL=usgsPeakStreamflow.js.map

package/dist/usgsPeakStreamflow.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@usa-open-data-connectors/usa-sources",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint .",
+    "format": "prettier --write \"src/**/*.{ts,json}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,json}\"",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo coverage",
+    "clean:all": "rm -rf dist tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo coverage node_modules",
+    "test:smoke": "RUN_SMOKE=1 vitest run src/smoke.test.ts"
+  },
+  "devDependencies": {
+    "@usa-open-data-connectors/config-eslint": "*",
+    "@usa-open-data-connectors/config-typescript": "*",
+    "@types/node": "22.20.4",
+    "eslint": "9.39.5",
+    "typescript": "6.0.3",
+    "vitest": "3.2.7"
+  },
+  "dependencies": {
+    "zod": "3.25.76"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Uniform TypeScript adapters for US public data sources"
+}