feat(validation): implement validate function and SchemaValidationErr…

[VatsalGoel3]

Summary

Changes

Please provide a summary of what's being changed

This PR improves the validate function by:

Ensuring correct handling of JMESPath expressions in the envelope parameter.
Adding type safety for formats to comply with Ajv's expectations.
Adding necessary type assertions for payload validation.
Fixing potential issues related to schema compilation failures.

Additionally, it adds comprehensive unit tests to cover:

Basic validation with valid and invalid payloads.
Validation with an envelope extracting nested objects.
Handling of custom formats and external schemas.
Proper error handling when schema compilation or validation fails.

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

Issue number: closes #3607

---

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 so much for the PR @VatsalGoel3, I left a few comments but nothing major.

--

Regarding your question about tests, I think you might've been mistakenly running both unit and end to end tests and because of this, it was trying to deploy resources to an AWS account.

If you want to run the tests for this package, use this command: npm run test:unit:coverage -w packages/validation from the root of the project.

[VatsalGoel3]

I have updated the code with the required changes. Please let me know if any other changes are needed.

Thank you

[dreamorosi]

Thank you for addressing the comments, a couple more things that were not addressed in the previous iteration - I made them clear.

[VatsalGoel3]

Sorry for missing some changes; I updated them; also for the first line in index.ts, I had it because of the corresponding indes.test.ts; I have updated that test suite as well to match the updated index.ts

[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 working on this PR!

If you're interested, you can take one between #3609 and #3608 which are a continuation of this one.

[dreamorosi]

@am29d need a second approval, because I made a commit to fix an import.