feat(parser): allow parser set event type of handler with middy

[am29d]

Summary

This PR introduces type inference for event type of handler when using parser with middy middleware. Based on the combination of provided inputs (schema, envelope, safeParse) the type can change between a single object, an array (i.e. SqsEnvelope) and safeParse, where we wrap the result into ParsedResult. I have modified the unit tests to use the inference which should have an error, if the type inference breaks.

Changes

• fixed return types to array for envelopes that return multiple items of provided schema objects
• added ParseOutput to narrow down the type of the modified event
• moved DynamoDBStreamEnvelopeResponse to types folder
• replaced eslit comments with type casts in unit tests as mentioned in our docs

Please provide a summary of what's being changed

Please add the issue number below, if no issue is present the PR might get blocked and not be reviewed

Issue number: closes #2407

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[dreamorosi]

Great work on these types, just left one minor comment about naming (& a suggestion to fix a typo).

Looking forward to merge it!

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarCloud

[dreamorosi]

Thank you for this improvement!