Release staging: PRs targeted for v1.1.4

[thodson-usgs]

Tracking issue for the next release after v1.1.3 (2026-04-09). Lists every PR — merged or in flight — that the next release will pick up, so the maintainers have a single page to look at when cutting it.

New features (mostly parity with the R package)

PR	State	Summary
#267	draft	waterdata.get_peaks — annual peak-streamflow / stage record (new OGC peaks collection).
#268	draft	waterdata.get_field_measurements_metadata — discrete-measurement analogue of get_time_series_metadata. Mirrors R's read_waterdata_field_meta.
#269	draft	waterdata.get_ratings — stage-discharge rating curves via the new STAC catalog. Mirrors R's read_waterdata_ratings.
#264	draft	waterdata.get_combined_metadata — joined location × time-series inventory. Mirrors R's read_waterdata_combined_meta.
#262	merged	waterdata.get_samples_summary — per-site inventory of discrete-sample data. Mirrors R's summarize_waterdata_samples.
#239	merged	waterdata.get_nearest_continuous — for N target timestamps, fetches the nearest continuous observation in one round-trip.
#234	draft	waterdata.SiteTypeCode / StatisticCode enums for parameter values.

Behavior / API changes

PR	State	Summary
#230	open	Switch WQP default profile from legacy to WQX3.0 (closes #121).
#233	draft	Use GET with comma-separated values for multi-value waterdata queries (closes #210).
#232	draft	Add tsv mimeType support and raise clear error for xlsx in WQP.
#229	draft	Validate monitoring_location_id format in waterdata getters (closes #188).
#238	merged	CQL filter / filter_lang passthrough on the OGC waterdata getters (auto-chunks long top-level OR chains).
#240	merged	Isolate the filter feature behind a clean rollback flag; document the lex-comparison pitfall.
#243	merged	Deprecate nadp ahead of 2026-11-01 removal.
#259	merged	Skip NADP live-API tests (module deprecated).
#228	merged	Remove waterwatch module.

Bug fixes

PR	State	Summary
#253	draft	utils.query: surface unhandled 4xx/5xx; stop mutating caller's payload.
#251	draft	get_nearest_continuous: accept scalar targets; raise on missing time column.
#249	draft	WQP_Metadata.site_info: bind as a real property and forward kwargs.
#245	draft	streamstats.Watershed: persist instance state; parse JSON via r.json().
#237	open	nwis.get_gwlevels deprecation: point users at the right replacement (closes #236).
#231	draft	NWIS dam sublocation timeseries: fix mangled column names (closes #177).
#254	merged	_arrange_cols: stop mutating the caller's properties list.
#255	merged	waterdata.get_stats_data: preserve geometry across continuation pages.
#247	merged	_format_api_dates: parse ISO 8601 datetimes (with Z, fractional seconds, offsets).
#246	merged	nldi: validate data_source on every call, not just cache-miss.
#256	merged	wqp polish: silence prints, fix exception shape, fix typos.
#252	merged	nldi: fix several user-visible bugs in get_features, get_flowlines, search.
#248	merged	get_reference_table: propagate limit to query args.
#250	merged	wqp.get_results: preserve user-supplied WQX3.0 dataProfile.
#257	merged	_handle_stats_nesting: tolerate missing drop columns.
#258	merged	nldi: raise ValueError (not TypeError) for invalid navigation_mode.
#227	merged	_read_rdb: fix IndexError when NWIS returns no data rows.
#225	merged	Simplify defunct stubs; fix O(n²) pagination concats.

Docs / repo hygiene

PR	State	Summary
#265	draft	Enrich waterdata getter docstrings with examples adapted from R (get_daily, get_latest_continuous, get_latest_daily, get_field_measurements); fix two malformed pre-existing example blocks discovered while running them as doctests.
#235	merged	Bump geopandas in dev requirements to 1.1.2 (GHSA-6497-prx7-gpmq).
#226	merged	Use PEP 639 SPDX license identifier in pyproject.toml.

Notes for the cutter

• Touch-the-same-file dependencies that may need rebases at merge time (resolutions are mechanical):
  • dataretrieval/wqp.py — Switch WQP default profile from legacy to WQX3.0 #230, Add tsv mimeType support and raise clear error for xlsx in WQP #232, Fix WQP_Metadata.site_info: bind as a real property and forward kwargs #249, plus the merged Fix get_results: preserve user-supplied WQX3.0 dataProfile #250, Polish wqp.py: silence prints, fix exception shape, fix typos #256.
  • dataretrieval/nldi.py — many merged PRs already, plus Point get_gwlevels deprecation at continuous/daily services #237 doesn't touch it.
  • dataretrieval/waterdata/api.py — every new-getter PR adds a function block; ordering is alphabetical/file-position so collisions are line-adjacent only.
• STAC dependency: Add waterdata.get_ratings for USGS stage-discharge ratings via STAC #269 (get_ratings) is the first non-OGC waterdata.* function. The new dataretrieval/waterdata/ratings.py module avoids touching the OGC pipeline.
• Live-API tests: most new tests hit api.waterdata.usgs.gov directly. Maintainers running the suite should set API_USGS_PAT to avoid 429s during CI / pre-release verification.

[thodson-usgs]

Released as v1.1.4 (2026-05-07).

Closing this tracking issue. PRs from the staging list that didn't make this release (still open / draft as of cut) will roll forward to the next milestone.

Carryover for the next release:

• Behavior / API: Add tsv mimeType support and raise clear error for xlsx in WQP #232 (tsv mimeType + xlsx error in WQP), Use GET with comma-separated values for multi-value waterdata queries #233 (GET with comma-separated multi-values), Validate monitoring_location_id format in waterdata functions #229 (validate monitoring_location_id), Point get_gwlevels deprecation at continuous/daily services #237 (nwis.get_gwlevels deprecation pointer)
• Bug fixes: utils.query: surface unhandled 4xx/5xx and stop mutating caller's payload #253 (utils.query 4xx/5xx + payload mutation), Fix get_nearest_continuous: accept scalar targets and missing time column #251 (get_nearest_continuous scalar targets), Fix WQP_Metadata.site_info: bind as a real property and forward kwargs #249 (WQP_Metadata.site_info), Fix Watershed class: persist instance state and parse JSON #245 (streamstats.Watershed state + JSON), Fix mangled column names for NWIS dam sublocation timeseries #231 (NWIS dam sublocation column names)
• Features: Add SiteTypeCode and StatisticCode enums for waterdata parameters #234 (SiteTypeCode / StatisticCode enums)
• Closed (won't ship): Switch WQP default profile from legacy to WQX3.0 #230 (WQP default-profile flip — closed in favor of mirroring R, which still treats WQX3 as opt-in beta)