AsyncAPI: Support Specification Extensions

Open
#243 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Stale
Tech stack
typescript

Research direction

Start with the linked asyncapi.yaml lines 48-54 and compare the referenced asyncapi-react rendering for the x-content-schema extension. Then locate the generator's AsyncAPI rendering entry point; done means user-defined x- extensions are surfaced while x-eventcatalog-* extensions remain distinct.

Written by the indexing model from the issue text.

Description

Use Case

I'd like to show information from own AsyncAPI Specification Extensions.

My exact use case is x-content-schema https://github.com/freaz/eventcatalog-bug-reporting/blob/main/asyncapi.yaml#L48-L54

But there will be other usecases for x- support to avoid need to go to rendered AsyncAPI and looking for the Message.

Proposed Solution

Perhaps somthing similar as in asyncapi-react would be enough.

https://freaz.github.io/eventcatalog-bug-reporting/docs/services/Example%20Service/1.0.0/asyncapi/asyncapi/#message-ExampleEvent
Image

Implementation Notes

It will need to distinguish between user extensions and EventCatalog's x-eventcatalog-*.

Community Notes
  • Please vote by adding a 👍 reaction to the issue to help us prioritize.
  • If you are interested to work on this issue, please leave a comment.
  • If this issue is labeled needs-discussion, it means the spec has not been finalized yet. Please reach out in the EventCatalog Discord.
Dominant language
TypeScript
Stars
16
Forks
15
Avg merge
3m
Merged PRs (30d)
7

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from event-catalog/generators

All issues in event-catalog/generators

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.