v0.2.4 Changelog
Release date: March 4, 2026
v0.2.4 is a feature release in the v0.2.x line with no breaking changes. All existing deployments and plugins can be upgraded without any modifications.
The companion Contracts v0.2.6 release adds the OnRoutePrefixResolved callback method to IApiPlugin, allowing plugins to optionally react to their final resolved route prefix at startup.
New Features
New: Route Prefix Resolved Callback (OnRoutePrefixResolved)
When a plugin has UseAutoRoutePrefix enabled, the host operator can override the plugin's route prefix via the RouteOverride section in appsettings.json. Plugins previously had no way to detect this override. Starting with v0.2.4, the host calls OnRoutePrefixResolved on the plugin after the prefix is determined:
void OnRoutePrefixResolved(string resolvedPrefix, bool isOverridden);| Parameter | Description |
|---|---|
resolvedPrefix | The final effective route prefix (without leading slash) |
isOverridden | Whether the prefix was overridden via RouteOverride configuration |
The method has a default empty implementation in IApiPlugin — not overriding it has no effect on normal plugin operation. Override it only when the plugin needs to log, expose, or depend on the final prefix at startup.
For detailed usage, see Route Registration → Detecting Route Prefix Changes.