Version 1.4

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.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.

---