Serverless service file Typescript definitions will never be outdated again!

Illustration for automated Typescript definitions generation

Since v1.72.0, the Serverless framework accepts as a valid service file in addition to the usual , and file formats.


A new repository is born this month in the Serverless organization. This repository, named , hosts an automated pipeline generating Typescript definitions based on JSON schemas in core Serverless framework.

Automated Typescript definitions generation pipeline

A few simple steps to use those new definitions

  • installing the definitions
  • importing the definition in your file with
  • use this type at the root of your service file export

The reason behind an automated pipeline

I wrote a detailed article explaining the benefits of using Typescript for IaC definition files. I strongly encouraged you to give it a go if you’d like to benefit from types, imports and references!

Until today, the only way to type Serverless service file with Typescript was to install the Serverless DefinitelyTyped package also known as . Once installed, this community maintained package exports a definition that can be used to type your service file configuration object. However, like all community maintained definitions in DefinitelyTyped, the quality of the definitions depends on the reactiveness and accuracy of the maintainers. Therefore, from times to times, these definitions might diverge from the actual accepted service file configurations, either being outdated or simply wrong. This defeats the purpose of having definitions to rely on to ensure service definition is formatted as expected.

Fortunately, Serverless internally uses JSON-schema and ajv to perform service file validation at the beginning of any Serverless CLI command. This validation helps massively by failing fast before a deployment, but Typescript types have the advantage of failing even faster, with direct feedback to the developer, in his IDE.

In order to tackle the issue of outdated DefinitelyTyped definitions, I implemented an automated pipeline to generate those Typescript definitions directly from the internally used JSON-schema of Serverless. This automated pipeline is triggered every time a new release of Serverless framework is available. The pipeline ends with the publishing of the newly generated definitions to NPM, ensuring they are always up to date and consistent with the framework internal validation logic.

The serverless/typescript repository is open-source and all contributions to improve the automatically generated definitions are welcome!



Tools, techniques, and case studies of using serverless to release fast and scale optimally.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Frédéric Barthelet

AWS Community Builder. @serverless/typescript maintainer and Serverless framework contributor.