Feature request: implement top-level await & ESM

[dreamorosi]

Description of the feature request

Problem statement
With ES modules, developers may use top-level await within their functions. This allows developers to use the await keyword in the top level of the file. With this feature, Node.js functions may now complete asynchronous initialization code before handler invocations.

In the context of the Parameters utility, this minimises the execution time in favor of a longer and single initialisation time as parameters that are shared across invocations could be fetched ahead and used immediately when the handler is executed.

Summary of the feature
For this feature to be possible two things need to happen:

• Feature request: build as esmodule #521 must be resolved and the all the harnesses to build in ESM must be available
• e2e tests must be implemented
• docs need to make it clear that top-level async/await can be used only with ESM

Code examples
N/A

Benefits for you and the wider AWS community
Shorter execution times, simpler handler logic

Describe alternatives you've considered
Fetching all secrets in the handler's scope.

Additional context
Depending on the strategy that is decided in #521 examples should be provided in the docs for both ESM and CJS since the latter won't have access to top-level async/await.

Related issues, RFCs

#846
#521

[github-actions]

⚠️ COMMENT VISIBILITY WARNING ⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.

[marcioemiranda]

Hey @dreamorosi , do you have an alpha release for this already?

[dreamorosi]

Hi @marcioemiranda, yes - I just published the first alpha release.

You can download it by running npm i @aws-lambda-powertools/parameters@next.

Note that I haven't yet been able to publish the docs, nor release notes, that's why I haven't announced it yet.

[dreamorosi]

This is available in preview starting from the 2.0.0-alpha.0 release. You can install this version using the next tag, i.e. npm i @aws-lambda-powertools/logger@next.