feat(logger): Flush buffer on uncaught error in Middy middleware

[ConnorKirk]

Summary

This PR adds support for flushing the log buffer when an uncaught error is encountered using middy middleware.

Changes

Please provide a summary of what's being changed

• Add flushBufferOnUncaughtError option to middy injectLambdaContext options
• Add clearBuffer method to the logger. This is needed to clear the buffer in the onAfter handler. An alternative I considered was changing the logic of the buffer to only handle one trace id at a time. If a log is buffered with a new trace ID, then the buffer could be reset.
• Split the injectLambdaContextAfterOrOnError into separate handlers . Simplify the names all the handlers.

Notes

• The target parameter of injectLambdaContext can be an array of loggers. I wasn't clear on the correct behaviour if there are multiple loggers provided. At the moment it will flush each logger.

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

Issue number: #3633

---

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]

Thank you for the PR Connor! Left a couple comments here & there but I think we are very close

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

[dreamorosi]

Thank you for the work on this feature, Connor!

This should be the last PR for this feature - we'll write the docs in the next days and expect to ship it on Friday.