Changelog
Source:NEWS.md
aradR 0.2.0 (release candidate)
Author and maintainer: Simona Malovana
Discovery UX
- Added
arad_catalog()for one-row-per-indicator browsing within an ARAD set, base, selection or explicit indicator list. - Added
arad_find()as a higher-level human-readable search across indicator names/IDs, ARAD hierarchy paths and, by default, base/dimension labels and values. -
arad_find()now returns deterministic, explainable relevance ordering throughrelevance_scoreandmatched_in; exact ID/name matches rank ahead of partial name/ID, path and dimension matches, with stable tie-breaking. -
arad_find(details = TRUE)enriches only matched indicators with available data boundaries, latest update timestamp and snapshot-context count. - Added
arad_info()for inspecting selected candidate series through a compact summary plus detailed dimensions and raw update rows. - Kept
arad_search()unchanged as the fast, lightweight name/ID search for backwards compatibility. - Clarified that ARAD-reported
data_tocan extend into forecast/report horizons and is not necessarily the latest observed historical date. - Updated onboarding and reference documentation around a browse → find → inspect → retrieve workflow.
Public endpoint and diagnostics
- Scoped aradR 0.2.0 to the public Czech National Bank ARAD API only.
- Removed the prerelease
arad_use_internal()/arad_use_external()endpoint-mode helpers and integrated Negotiate/proxy-bypass transport so private-network authentication can evolve separately from the public package. - The default endpoint can no longer be redirected through the legacy
aradR.base_urloption; explicitbase_urlarguments remain available for testing and advanced request control. - Improved pre-response HTTP diagnostics so proxy/connection failures retain the underlying redacted error instead of collapsing to a generic message; HTTP 401 responses are classified as authentication errors with public-API-key guidance.
- Added an early compatibility check for the HTTP stack: legacy
httr2 0.2.2remains supported, whilehttr2 >= 1.2.0is paired with its requiredcurl >= 6.4.0; incompatible installations now fail with an actionable update-and-restart message.
Live validation and compatibility
- Live 0.2.0 UX acceptance covers catalogue browsing and end-to-end find → info → get → wide workflows in balance-of-payments, financial-accounts and state-budget scopes.
- Added compatibility with the current
/indicators-dimsbase_coderesponse while preserving the stable publicbase_idcolumn; legacybase_idresponses remain supported. - Release-candidate CI validates package checks across Ubuntu, macOS and Windows and builds the pkgdown documentation site before release.
aradR 0.1.0 (pre-release)
Author and maintainer: Simona Malovana
Reliability core
- Added the initial public API:
arad_get()andarad_updates(). - Added strict exactly-one-selector validation for indicator, set, base, and user-selection requests.
- Added character-first ARAD CSV ingestion followed by explicit date and numeric parsing.
- Added integrity checks for required columns, malformed non-missing values, and conflicting duplicate observation keys.
- Added deterministic chunking for long histories and
/updates-based boundary discovery. - Added safe collapse of identical cross-chunk boundary overlaps.
- Added request retries, API-key redaction, retrieval diagnostics, unit tests, and opt-in live regression tooling.
Discovery and metadata
- Added
arad_indicators()for basic indicator metadata. - Added
arad_dimensions()for base/dimension metadata. - Added
arad_tree()for ARAD hierarchy paths. - Added
arad_snapshots()for snapshot discovery. - Added
arad_search()for scoped local search over indicator IDs and names, including frequency filtering.
User workflow
- Added
arad_wide()for safe long-to-wide reshaping with automatic snapshot disambiguation. - Added an end-to-end Get Started vignette.
- Added a troubleshooting guide, contribution guidance, package citation metadata, and pkgdown site configuration.
- Reworked the README around installation and a discovery → retrieval → reshape workflow.
Caching and validation
- Added explicit
none,session, anddiskraw-response cache modes; caching remains disabled by default. - Added
arad_cache_clear()and configurable cache age/location. - Cache entries are credential-separated using a one-way API-key hash; API keys are not persisted.
- Added automated tests for metadata schemas, caching behaviour, malformed metadata, and wide reshaping.
Live audit
- Added stratified audit sampling and comparison logic that distinguishes key, missing-value, and numeric mismatches.
- Completed the initial M/Q/Y/D, multi-indicator and snapshot-backed reliability calibration.
- Retained the 3650-day production chunk size after exact agreement with finer references across the completed audit matrix.
- CI is cost-controlled: routine package PRs use one Ubuntu check, while the broader live audit and multi-OS checks are reserved for justified reliability/release validation.