6 Event Types

6.1 released

Category: Version Event

Indicates when a component version is released and available for use.

Additional Required Fields:

  • version - The version string of the released component

Additional Optional Fields:

  • license - License identifier that summarizes the license as declared in the component's metadata

6.2 endOfDevelopment

Category: Version Event

The manufacturer or maintainer ceases work on Substantial Modifications for a specific version or version range of a component or service. Security Fixes and Bug Fixes will continue to be provided for this specific version or version range until endOfSupport is declared, but no new features or enhancements will be added.

Additional Required Fields:

  • versions - Array of version specifications
  • supportId - Reference to a support policy defined in the definitions section

6.3 endOfSupport

Category: Version Event

The manufacturer or maintainer ceases providing Security Fixes and Bug Fixes for a specific version or version range of a component or service.

The supportId field MUST be included and used to specify which support policy is ending, referencing a support policy defined in the definitions section.

Additional Required Fields:

  • versions - Array of version specifications
  • supportId - Reference to a support policy defined in the definitions section

6.4 endOfLife

Category: Version Event

The manufacturer or maintainer formally ceases all work (including Distribution, Substantial Modifications, Bug Fixes, Security Fixes, Documentation, and Maintenance) for a specific version or version range of a component. No further updates, support, or distribution will be provided for this specific version or version range. The component is considered retired.

Additional Required Fields:

  • versions - Array of version specifications

6.5 endOfDistribution

Category: Version Event

The manufacturer or maintainer ceases distribution of a specific version or version range of a component or service. This should only be used when the manufacturer has control over the distribution of the component or service.

Additional Required Fields:

  • versions - Array of version specifications

6.6 endOfMarketing

Category: Version Event

The manufacturer or maintainer ceases marketing and promotion of a specific version or version range of a component or service. The component or service may still be available, and existing support policies may remain in effect, but the manufacturer will no longer seek new customers or promote its use.

Additional Required Fields:

  • versions - Array of version specifications

6.7 supersededBy

Category: Version Event

Indicates when a version of a component is superseded by another version of a component. This should only exist for components in which version progression is not implicit.

Additional Required Fields:

  • supersededByVersion - Plain version string that supersedes it

Additional Optional Fields:

  • versions - Array of version specifications

6.8 componentRenamed

Category: Component Event

Indicates when a component is renamed.

Additional Required Fields:

  • identifiers - Array of identifier objects specifying the new identifiers for the component

Additional Optional Fields:

  • description - Human-readable description of the event
  • references - List of URLs to supporting documentation

6.9 withdrawn

Category: Meta Event

Indicates that a previously published event is being withdrawn or revoked. This is used in a prepend-only event model where events cannot be modified, only new events can be added. When an event is withdrawn, it should be ignored during processing as if it never existed.

Additional Required Fields:

  • eventId - The ID of the event being withdrawn

Additional Optional Fields:

  • references - List of URLs to supporting documentation
  • reason - Human-readable explanation for why the event is being withdrawn