@stoplight/types provides common TypeScript typings used across the Stoplight ecosystem, with published API interfaces and a changelog. It is useful for developers integrating Stoplight tools like Stoplight Prism and related components in modern browsers and Node.
Project status
- Maintenance status: stoplightio/types appears quiet/dormant, with the last upstream push on 2024-12-09 (and no newer listed updates after early 2024), so it does not look actively maintained as of 2026-08-13.
- Update cadence: updates are irregular, with several releases in 2023, then a relatively small 2024-01-05 update, and then a long gap until the last observed upstream push in late 2024.
AI summary generated
Recent updates
v14.1.1
v14.1.1 is a small bug fix release that adds support for a missing webhook node type. The release notes mention the missing webhook node type as the only change.
v14.1.0
v14.1.0 adds OAS 3.1 webhooks support to the HTTP types. The core change is a new `webhooks` collection on the bundled HTTP service type, along with new operation interfaces to represent endpoint operations vs webhook operations.
BreakingFeaturesv14.0.0
v14.0.0 updates the HTTP spec TypeScript types to align how security is modeled on IHttpService. The release explicitly calls out a breaking change where IHttpService.security becomes a 2D array.
Breakingv14.0.0-beta.1
This beta release updates the http-spec typing for the OpenAPI `security` field to support security groups. It also adjusts CI workflow branch filtering to include the `beta` branch.
BreakingFeaturesv13.20.0
Release v13.20.0 adds support for service-level info extensions in the HTTP spec types. The change is implemented as a new optional property on the IHttpService interface.
Featuresv13.19.0
v13.19.0 adds support for tracking unknown OAS parameters as components. The only observed code change is a new TypeScript field on the bundled HTTP service interface.
Featuresv13.18.0
v13.18.0 adds support for OpenAPI-style vendor extensions by introducing a shared spec extensions type and wiring it into many HTTP-related nodes and objects. The change centralizes the `extensions` typing and propagates it across graphs, operations, content, and related structures.
Featuresv13.17.0
v13.17.0 extends the HTTP type spec with callback support, including adding callbacks at the component/service level. It also adjusts the callback typing to support keyed references.
Featuresv13.16.0
v13.16.0 extends the HTTP type system to support an externalDocs object on HTTP services, operations, and tag definitions. The code change introduces a new IExternalDocs interface and wires an optional externalDocs?: IExternalDocs field into the relevant node interfaces.
Featuresv13.15.0
v13.15.0 introduces a new HTTP parameter style enum value, HttpParamStyles.Unspecified, to represent cases where an OAS parameter style is not specified. The change updates path, query, header, and cookie parameter type definitions so their style fields accept this new value in addition to existing allowed styles.
Features