Feature request: Export the `parse` function within the parser package

[nateiler]

Use case

The [parse](https://github.com/aws-powertools/powertools-lambda-typescript/blob/main/packages/parser/src/parser.ts) function is valuable but not exported from the parser package. The middleware and decorator use it, however it would also be useful in manual parsing scenarios too; specifically because it throws a parse error which can handled uniformly with other middleware.

Solution/User Experience

Parsing an API Gateway Proxy Event query string parameters

const params = parse(event.queryStringParameters, undefined, QuerySchema);

And we could expect to uniformly handle a parse error whether it happens from a failed body or query string parameters.

Alternative solutions

Acknowledgment

• This feature request meets Powertools for AWS Lambda (TypeScript) Tenets
• Should this be considered in other Powertools for AWS Lambda languages? i.e. Python, Java, and .NET

Future readers

Please react with 👍 and your use case to help us understand customer demand.

[dreamorosi]

Hi @nateiler, thank you for opening this issue and for bringing this up.

I agree that the parse function should be exported, and I've been meaning to do this for a while but was waiting to see if there was actual demand.

I'll add this to the backlog, would you like to open a PR to do it by any chance? If not, we'll try to pick it up before the next release.

[dreamorosi]

@sdangol I assigned this to you, so we can make sure it's released tomorrow - should be an easy one.