Option to bundle / split?

[lukeocodes]

It would be really helpful to support this just as openapi-format does.

[thim81]

hi @lukeocodes

Let me investigate what is possible, but it does make a logical addition.

[lukeocodes]

thanks @thim81, let me know if I can help at all

[lukeocodes]

I popped a PR up, but I think api-ref-bundler is breaking AsyncAPI v3 semantics. It shows support up to v2, which is probably why.

It dereferences things very nicely, but it points operation message references at #/component/messages/... instead of leaving them pointing at #/channels/.../messages/.... Slightly frustrating, maybe something I can fiddle my way out of.

[thim81]

I used the api-ref-bundler because of the support it has for most OpenAPI & AsyncAPI version.
It mentions that there is no AsyncAPIi 3.x, but it is part of the roadmap.

We have 2 options here: or create a PR to introduce support for AsyncApi 3.x on the api-ref-bundler package
or create a separate logic that handles this inside asyncapi-format.

I tend to always try to contribute back to the community tooling, so I would consider option 1 the most ideal, but it has to be feasible. Haven't been looking into the differences between AsyncAPIi 2.x and 3.x, so it would require some catching up todo.

[thim81]

hi @lukeocodes

I did attempt to create a PR on the api-ref-bundler package to bring support for AsyncAPI v3.

Perhaps you can reference this in your local setup to see if this delivers the results you expect, while we wait for feedback on the PR.

[lukeocodes]

Oh I sat down this morning and started looking to make a PR here. I'll review what you have and see if it helps

[thim81]

hi @lukeocodes

That would be greatly appreciated. If you could give it spin and see what it generates, if it does what you expect.

Or perhaps share what you expect, so I can take it try out myself.

[thim81]

hi @lukeocodes

You PR on the api-ref-bundler package, looks more detailed and covers more cases, so great job! 👏
Let's see how the PR progresses after review by Udamir.

While we wait, anything else I can look into for you?