Docs: Cookiecutter project template with TypeScript Powertools setup (with SAM)

[ijemmy]

Description of the feature request

Problem statement
Setting up in TypeScript development environment is difficult and require a lot of manual steps. For users who want to test PowerTool without integrating it into an existing TypeScript project, it could take a very long time (hours, or even days to get config right).

Summary of the feature
We provide a Cookiecutter template with TypeScript PowerTool already setup. It has API + 3 functions that uses all 3 core features

Each function will use the following options:

1. Manually
2. Middy Middleware
3. Decorator

Code examples
sam init --location gh:aws-samples/cookiecutter-aws-sam-typescript-with-powertools

Ref documentation

Benefits for you and the wider AWS community

1. Ease of learning for new users. They can test it in actual live environment (required for feature like Tracer) instead of just looking at the code.
2. Ease of starting a new project. This increases adoption speed.

Describe alternatives you've considered
N/A

Additional context
N/A

Related issues, RFCs

N/A

[dreamorosi]

Here some references of cookiecutter-based project from Python & Java.

If using SAM cookiecutter is nice, as alternative I'd like to also pitch creating a projen template (they accept PRs to add templates) for those who don't use SAM & just want a nice TS setup.

[michaelbrewer]

@dreamorosi sam now supports Typescript. So it might be a good time to add this :)

[dreamorosi]

@dreamorosi sam now supports Typescript. So it might be a good time to add this :)

See aws/aws-sam-cli-app-templates#193

To manage expectations: this is still in a preliminary phase as TS was just added to SAM and there's a few things we want to settle on our side before merging that PR, but we're on it.

[VRMink]

@michaelbrewer, do you have a link describing typescript support in SAM?
As this issue suggest, I have just spent 2 days trying to get SAM to play nice with TypeScript, I came here to see how you guys had managed to do it, and to adopt your Powertool.

Looking forward to seeing this solution come alive, till then I will be using JS

[michaelbrewer]

@VRMink https://aws.amazon.com/blogs/compute/building-typescript-projects-with-aws-sam-cli/

[dreamorosi]

Hello @VRMink we are also working on adding SAM examples to this repo, you can track progress under this PR.

[dreamorosi]

Hi @VRMink, we have added an example that uses SAM & TypeScript to this repo, you can find it under examples/sam.

A cookiecutter template for SAM it's also on its way aws/aws-sam-cli-app-templates#193.