asyncapi-react icon indicating copy to clipboard operation
asyncapi-react copied to clipboard

Schemas in AsyncAPI 3.0.0 file not fully rendered (only example1 parsed correctly)

Open juanmbco opened this issue 8 months ago • 4 comments

Description Hi guys!

There is an issue rendering the schemas declared in an AsyncAPI 3.0.0 document. For the following specification, only example1 is correctly parsed and displayed; however, example2 and example3 do not show the specific schema structure, and their definitions are missing or unresolved in the rendered output.

This appears to be a problem with how nested or referenced Avro schema types are handled—particularly when the type is declared as a named reference (example.field.ExampleField), rather than defined inline.

Thanks in advance. Best regards, Juan

Expected result

All three fields (example1, example2, example3) should resolve to the ExampleField schema and display the field structure correctly.

Actual result

  • example1: Parsed and rendered correctly.

  • example2: Schema is not correctly displayed.

  • example3: Schema is not correctly displayed.

Steps to reproduce

  1. Use the following AsyncAPI file as input:
asyncapi: 3.0.0
info:
  title: Account Service
  version: 1.0.0
  description: This service is in charge of processing user signups
channels:
  example:
    address: example
    messages:
      ExampleEvent:
        $ref: '#/components/messages/ExampleEvent'
operations:
  sendUserSignedup:
    action: send
    channel:
      $ref: '#/channels/example'
    messages:
      - $ref: '#/channels/example/messages/ExampleEvent'
components:
  messages:
    ExampleEvent:
      name: ExampleEvent
      title: Example Event
      summary: Contains the event type some data
      contentType: application/avro
      payload:
        schemaFormat: "application/vnd.apache.avro+json;version=1.9.0"
        schema:
          name: Example
          namespace: example.message
          type: record
          fields:
            - name: example1
              type:
                type: array
                items:
                  name: ExampleField
                  namespace: example.field
                  type: record
                  fields:
                    - name: test
                      type: string
            - name: example2
              type:
                type: array
                items: example.field.ExampleField
            - name: example3
              type: example.field.ExampleField
  1. Render the spec in the AsyncAPI parser/viewer.
  2. Observe how only example1 is displayed correctly. The schemas for example2 and example3 are either missing or empty.

Image

Troubleshooting N/A

juanmbco avatar Apr 22 '25 10:04 juanmbco

Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

github-actions[bot] avatar Apr 22 '25 10:04 github-actions[bot]

Hi @juanmbco can I start working on this issue

Devnil434 avatar May 30 '25 12:05 Devnil434

Hi @Devnil434 Have you worked on this issue? Sorry, I only check with an emoji 2 weeks ago

Best regards, Juan

juanmbco avatar Jun 10 '25 14:06 juanmbco

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

github-actions[bot] avatar Oct 09 '25 00:10 github-actions[bot]