fix(openapi-typescript): include location in error messages

[patzick]

Changes

• improved error messages - added locations to help find the problem in schema
• do not throw error on first problem - display all the problems with the schema before throwing an error - helps to find out how many things are broken in schema
• repeated code moved to internal method, reused in both Validation and Bundling

Examples:

• from ✘ Can't resolve $ref to ✘ Can't resolve $ref at #/components/schemas/Pet/properties/type
• from Expected SchemaObject, received Array to Expected SchemaObject, received Array at #/components/schemas/someSchema

How to Review

Apart of more explicit error messages the only change is in not throwing the first problem, but rather display all the problems to help quickly fix them before the next run. This is not affecting the application flow, as the Error is still thrown right after problems are processed.

Checklist

• Unit tests updated
• docs/ updated (if necessary)
• pnpm run update:examples run (only applicable for openapi-typescript)

[changeset-bot]

🦋 Changeset detected

Latest commit: a2f5dff

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
openapi-typescript	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[patzick]

hey @kerwanp, can you review it or point me to the person who should review it? Would be nice to have this in the next patch version as debugging broken schemas is very hard without it :)

[kerwanp]

Hi @patzick, thanks for the contribution! I would take a look at it this weekend.

[patzick]

hey @kerwanp any chance to push this forward?