@awboost/cfntypes

@awboost/cfntypes

Typescript types for AWS CloudFormation types.

Template Types

The template types are available via the template package subpath. For performance reasons, the resources are not fully typed, i.e. no type-checking is done for valid Type or Properties values.

import { Template } from "@awboost/cfntypes/template";

const template: Template = {
  Resources: {
    MyFunction: {
      Type: "AWS::Lambda::Function",
      Properties: {
        // omitted for brevity
      },
    },
  },
};

Resource Types

Instead, the accurate resource types can be imported from the resources/* package subpath.

import { LambdaFunction } from "@awboost/cfntypes/resources/AWS-Lambda";
import { Template } from "@awboost/cfntypes/template";

const template: Template = {
  Resources: {
    MyFunction: new LambdaFunction("MyFunction", {
      // props go here
    }).toJSON(),
  },
};

The attributes of the resource can be conveniently accessed in the resource instance.

const instance = new LambdaFunction("MyFunction", {
  // props
}).addToTemplate(template);

// all of the attributes are available via the attributes property.
// this property actually returns { "Fn::GetAtt": [...] } intrinsic function.
const arn = instance.attributes.Arn;