Version 0.15 • artutils

artutils 0.15.0

This release focuses on documentation improvements, removal of demo mode guards, test cleanup, file reorganization, and codebase hygiene.

Demo Mode Guards Removed
- Removed artcore::is_demo() checks from all database modification functions
- Demo mode enforcement now handled at the application layer
- Affected functions: dbArtAppend(), dbArtUpdate(), addArtwork(), addCollection(), updateArtistStats(), updateArtistBenchmarks(), upsert_artist_preferences(), update_collection_settings()

Database File Reorganization
- Created db-interface.R with low-level database functions (dbArtGet(), dbArtAppend(), dbArtUpdate())
- Refactored db-modify.R to contain only data modification functions (addArtwork(), addCollection(), updateArtistStats(), updateArtistBenchmarks())
- Moved artHasNFT() from db-modify.R to db-artwork.R (it’s a data-access function)
- Each file now contains functions from a single @family group
Test Reorganization
- Created test-db-interface.R with live database tests for read operations
- Updated test-db-modify.R to only contain data modification tests (mocked)
- Added artHasNFT test to test-db-artwork.R
- Read-only tests use live database queries; write operations use mocks
Roxygen Documentation Quality
- Updated function titles to explain WHY (not just WHAT) for all exported functions
- Reference index now shows actionable descriptions like “Resolve URL slug to artist profile for page routing”
- Topic pages (@name blocks) use @keywords internal to prevent duplicate entries in reference
pkgdown Reference Organization
- Topic pages no longer appear as separate entries in the reference index
- Functions grouped cleanly by family without organizational noise

Fixed is_collection_visible() calling undefined get_artist_preferences() - replaced with inline database query
Fixed R CMD check notes for unused imports (rlang, shiny removed from Imports)
Added @importFrom lifecycle badge to properly import lifecycle package

Stub Files Deleted
- R/calcArtworkBenchmarks.R - was just a redirect comment
- R/settings-artist-prefs.R - was just a redirect comment
- R/settings-visibility.R - empty topic page with no functions
Internal Function Tests Removed
- Removed tests for .calc_benchmarks() and .parseBenchmarkRow() from test-benchmarks.R
- Internal functions (prefixed with .) are not tested directly
- Benchmark functionality tested via public updateArtistBenchmarks()