NEWS

epidatr 1.3.0

Improve documentation, including descriptions for save_api_key() and endpoint parameters, and standardize parameter information (#324 and #334).
Modernize internal API architecture by migrating from httr to httr2.
Introduce a centralized validation system in R/check.R using checkmate to standardize input checking, date parsing, and API parameter formatting.
Refactor epidata_call and do_request to use httr2 request objects, implement automatic GET-to-POST fallback, and add robust retry logic.
Improve file-level documentation by adding summary descriptors at the top of all R source files.
Deprecate debug and format_type arguments in fetch_args_list().

Added new epidata, epidata_meta, epidata_snapshot, and epidata_archive for accessing the Delphi V5 API.
pub_covidcast_meta() gained signals, time_type, and geo_type arguments for server-side filtering of the metadata results.

last_update in pub_covidcast_meta is now returned as a POSIXct object instead of an integer.
Improved efficiency of date parsing for API responses.
Migrate HTTP requests from httr to httr2.
Update endpoint examples to skip execution when required API keys or internet connectivity are unavailable, ensuring cleaner R CMD check results.
Add lifecycle to DESCRIPTION to properly manage function deprecations.

Validate that time_type is one of "day" or "week" in pub_covidcast.
Validate that time_type is "week" when source is "nssp" in pub_covidcast.
Allow hsa_nci as a geo_type in pub_covidcast.
Allow hsa_nci as a geo_type in pub_covidcast_meta.
pub_covidcast_meta now returns min_time, max_time, max_issue as integers rather than Dates. Because these fields can mix YYYYMMDD and YYYYWW values, we recommend you parse them yourself.
add new fields for flusurv endpoint.

Improve handling of the EPIDATR_USE_CACHE environment variable, allowing it to be any value convertable by as.logical() and handle the case when it can't be converted.
Support more date formats in function to convert dates to epiweeks. Use parse_api_date since it already supports both common formats. #276
EPIDATR_USE_CACHE only supported exactly "TRUE" before. Now it supports all logical values and includes a warning when any value that can't be converted to logical is provided. #273
missing doesn't count default values as non-missing. If a user doesn't pass geo_values or time_values (both of which default to "*" in pub_covidcast), or dates (in pub_covid_hosp_state_timeseries), the missing check fails. To avoid this, just don't check missingness of those two arguments.
fetch_args_list now has an refresh_cache argument, which is FALSE by default.

Fix failure when passing as_of values in Date format to pub_covidcast while caching is enabled (#259).
For pub_covidcast data source nchs-mortality, parse dates as epiweek and expect epiweek inputs from user (#260).
Fix failure in pub_covidcast when user doesn't pass geo_values or time_values, even though those arguments have defaults (#268).

pub_covid_hosp_state_timeseries now supports use of the as_of parameter (#209).
release_date and latest_update fields are now parsed as Date, rather than as text. This change impacts several endpoints.
get_auth_key renamed to get_api_key (#181).
get_api_key no longer reads from R options and only uses environment variables (#217).
pvt_twitter and pub_wiki now use time_type and time_values args instead of mutually exclusive dates and epiweeks (#236). This matches the interface of the pub_covidcast endpoint.
Updated the default timeout_seconds to 15 minutes to allow large queries by default.

Function reference now displays commonly-used functions first (#205).
Support Date objects passed to version arguments as_of and issues in endpoints (#192, #194).
clear_cache now handles positional arguments just like set_cache (#197).
set_api_key now available to help persist API key environment variables (#181, #217).
All endpoints now support the use of "*" as a wildcard to fetch all dates or epiweeks (#234).

Endpoints now fail when passed misspelled arguments (#187, #201).
pub_fluview_meta fixed to fetch the response automatically.
pub_covid_hosp_state_timeseries now correctly parses the issue field, instead of returning a missing value (#202).
In pub_fluview_meta, latest_issue field is now parsed as epiweek, rather than being parsed as Date and returning a missing value.
set_cache cache size no longer runs into integer overflow (#189).
Improve line-wrapping of warning messages (#191).
Fix documentation related to CRAN submission.
Fix some errors from passing "" as a key.
Fixed bug with NAs when parsing ints (#243).

Major interface change: all endpoints now fetch by default.
Make all fetch function internal.
Change fetch and fetch_* function interfaces now rely on fetch_args_list.
Added fetch_args_list which returns a list of arguments to be passed to fetch.

Fix source name duplication bug in covidcast_epidata.
Mark covidcast_epidata as experimental and do not export it.
Change covidcast arg data_source to source.
Make covidcast args issues, lag, and as_of mutually exclusive.
Make covid_hosp_facility_lookup args state, ccn, city, zip, and fips_code mutually exclusive.
Update documentation to only refer to character or strings (not character vectors or character strings).

Update README.md for better onboarding.
Consolidate the vignettes into one. Clean up the code, do not eval most examples.

The fetch_{tbl,classic,df,json,csv} functions have been replaced by the fetch() function, which almost always returns a tibble, except when used with a limited number of older endpoints (such as delphi() and meta()), where it will output a nested list structure.

The package that this installs is being renamed from delphi.epidata to epidatr. To migrate, run the installation command above, followed by remove.packages("delphi.epidata"), and adjust all references to the package name accordingly.