fix(parser): fix cause errors nested structure

[am29d]

Summary

This PR fixes the bug of nested errors inside the ParsedResultError structure.

Changes

In the generic Envelope we have returned a ParsedResultError structure

{
	success: false,
	error: new ParseError('foo'),
	originalEvent: data
}

In all cases the Envelope was called from specific envelopes such as ApiGateway, EventBridge etc. and in all of such cases we repackage the entire response again, which causes error.cause to be ParseError (from the Envelope call), and the not the expected ZodError.

Therefore, the Envelope.safeParse now returns a generic error or whatever we catch within the safeParse and no originalEvent. The reason for that is that the specific envelope has the entire original payload and should have the responsibility to return this information back to the user. At that point the originalEvent is not relevant for the Envelope object at all.

I had to modify the return because TypeScript is not aware of the if-statement before the return:

if (!parsedEnvelope.success) {
      return {

      };
    }
	
    return parsedBody as ParsedResultSuccess<z.infer<T>>;

I have also added more specific error assertions in the tests.

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 #3208

---

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 fixing the issue and for the PR, Alex.

I have left a minor comment in one of the envelope files, but it's not a blocking one. Feel free to merge as-is if you prefer to leave 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