feat(parser): DynamoDBMarshalled helper to parse DynamoDB data structure

[arnabrahman]

Summary

When working with Amazon DynamoDB Stream events, the service sends the DynamoDB items in the database-specific format rather than regular JSON objects.

For example, a string might be represented as { "S": "foo" } rather than just foo. This makes parsing the actual changes within an event hard to parse and validate since it requires customers writing a Zod schema with this in mind.

This PR introduces a helper function DynamoDBMarshalled to work this structure

Changes

• Helper function to unmarshall and validate dynamoDB stream schema
• New helper function is exported to a subpath
• Unit test the new helper function
• Write up the docs for the new helper function

Issue number: #3194

---

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]

Hi @arnabrahman - I just got back from my annual leave.

I will review this PR by the end of the week.

Thank you for your patience and happy new year!

[arnabrahman]

Hi @dreamorosi , welcome back! I hope you had a refreshing holiday and wish you a happy new year as well.

[dreamorosi]

Thank you for the PR and for your patience!

I have a minor comment in the signature of the helper so that it's aligned with the underlying unmarshall function, but other than that I am ready to approve the PR.

[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 SonarQube Cloud

[dreamorosi]

Thank you for the PR!

[dreamorosi]

Just as FYI @arnabrahman - Over the next couple of weeks the team and I will invest time in creating a roadmap and backlog for the next two quarters.

With that, we'll be creating a number of issues and label them accordingly.

[arnabrahman]

@dreamorosi Thanks for the update, will be looking forward to it 🚀