Changelog

Source: NEWS.md

artcore 1.4.1

New features

• [is_valid_uuid()] provides boolean UUID validation for conditional logic. Returns TRUE/FALSE instead of throwing errors like [validate_uuid()]. Use when checking UUID validity in if statements or validation flows.

---

artcore 1.4.0

New Features

• API Utilities - Added shared HTTP request utilities for API client packages:
  • http_retry() - Execute HTTP requests with exponential backoff retry on transient errors (429, 5xx)
  • http_validate_status() - Validate HTTP response status codes with informative errors
  • .is_transient_error() - Internal helper to identify retryable errors
• Configuration Utilities - Added helpers for API configuration management:
  • api_config() - Retrieve API configuration from environment variables using standardized prefix pattern
  • api_key_required() - Validate required API keys with informative error messages
• Operators - Added null coalescing operator:
  • `%||%` - Return first non-NULL value (common pattern across API packages)
• Image Utilities - Added image processing utilities:
  • b64EncodeImage() - Encode images to base64 PNG strings for AI vision APIs
    • Supports local files and HTTP/HTTPS URLs
    • Automatic resizing to configurable max width (default 1000px)
    • URL reachability validation before processing

Dependencies

• Added to Imports: base64enc, magick
• Dependencies alphabetized for consistency

Purpose

These utilities consolidate common patterns from API client packages (artgemini, artopenai, artsend, artopensea) into artcore, eliminating code duplication and ensuring consistent behavior across the platform.

---

artcore 1.3.0

Breaking Changes

• Deprecated function aliases removed - The following camelCase function stubs that threw errors directing users to snake_case equivalents have been removed entirely:
  • ..dbc() - Use dbc() instead
  • ..dbd() - Use dbd() instead
  • genArtistID() - Use gen_artist_id() instead
  • genArtworkID() - Use gen_artwork_id() instead
  • genCollectionID() - Use gen_collection_id() instead

Removed

• R/deprecate.R - All deprecated function stubs removed
• R/utils.R - Development helpers (dev_artist(), dev_artwork()) migrated to arthelpers package

---

artcore 1.2.0

Breaking Changes

• Function renames to snake_case - All functions now follow snake_case naming convention:
  • ..dbc() → dbc()
  • ..dbd() → dbd()
  • genArtistID() → gen_artist_id()
  • genArtworkID() → gen_artwork_id()
  • genCollectionID() → gen_collection_id()
• Deprecated functions error immediately - Old function names are still exported but now throw an error directing users to the new names.