heft-serverless-stack-plugin

@rushstack/heft-serverless-stack-plugin

This is a Heft plugin for building apps using the Serverless Stack (SST) framework. With this approach, the SST toolchain is only used for synthesizing CloudFormation stacks and deploying the app, and Heft takes over the role of compiling, linting, testing your TypeScript project.

The plugin accepts two command-line parameters:

• --sst can be appended to heft build or heft start, causing the corresponding SST operation to be invoked

• --sst-stage STAGE_NAME allows you to customize the stage. It is equivalent to the --stage parameter for the SST command-line tool.

The plugin has no effect without the --sst parameter. When the parameter is provided:

• heft build --sst will behave similar to sst build, which synthesizes CloudFormation stacks in the build/cdk.out/ directory. See this documentation for details. Heft's --watch mode is also supported.

• heft start --sst will behave similar to sst start, which deploys a stub lambda to AWS and then launches the WebSocket client locally for debugging. See this documentation for details.

Note that heft build --sst currently requires AWS credentials, which limits the ability to perform this validation in a monorepo environment where we can't assume that every developer works on AWS. Issue serverless-stack#1537 is tracking a possible improvement.