Skip to content

PluginLifecycleEventPayload.apiVersions

PluginLifecycleEventPayload › apiVersions

Type: readonly string[]

The contract versions the plugin published, empty when it publishes no API.

An array rather than a single version because a provider may publish several contract versions side by side, so consumers pinned to an older range keep working across a breaking change.

The API objects themselves are deliberately NOT here. A handle delivered by a one-shot event is a probe: it answers "now" and never says when "now" changed, and one that outlives the provider is exactly the stale handle the plugin-api registry's revocable handles exist to prevent. Reach the API through watchPluginApi instead, whose reference stays correct across unload and re-enable.