ConfigurationAPI 1.2.0

1.2.0 — Configuration API Improvements

Added

• Added strict validation to ConfigLoadResult
• Enforces valid state combinations (status, config, error)
• Added ConfigManager#shutdown() for proper watcher lifecycle management
• Added safer internal config loading via getInternal(...)
• Improved YAML validation in GlobalConfigWatcher
• Prevents invalid/empty YAML from overwriting valid configs
• Added rollback protection on reload failure

Improved

• Improved configuration reload stability and safety
• Enhanced debounce handling for file system events
• Reduced unnecessary reloads using checksum comparison
• Improved event firing logic (only fires on valid state transitions)
• Better logging for reload failures and invalid YAML

Internal

• Strengthened immutability guarantees for YamlConfig
• Improved thread-safety clarity and consistency
• Cleaner watcher registration logic (putIfAbsent)
• Refactored internal loading flow in ConfigManager

Documentation

• Full Javadoc overhaul across entire API
• Added @since to all public methods and classes
• Made Javadoc fully doclint-compliant
• Fixed HTML issues (@apiNote, @implSpec, etc.)
• Improved clarity, structure, and consistency of documentation

Build

• Fixed Maven Javadoc build failures
• Ensured javadoc:jar passes without warnings/errors

What's Changed

• refactor(docs): standardize Javadoc across API and improve internal documentation by @devspexx in #13

Full Changelog: v1.1.0...1.2.0

Java CI With Maven: https://github.com/devspexx/ConfigurationAPI/actions/runs/24002413257/job/70000500882