Skip to content

AsyncAPI 2.x and 3.0 - #9

Merged
dskripchenko merged 1 commit into
mainfrom
feat/asyncapi
Oct 30, 2026
Merged

dskripchenko merged 1 commit into
mainfrom
feat/asyncapi

Conversation

@dskripchenko

Copy link
Copy Markdown
Owner

Reads and shows AsyncAPI documents, next to OpenAPI.

Core

  • loadAsyncApi(text | object) — AsyncAPI 2.0–2.6 and 3.0 into one shape:
    • servers (2.x url; 3.0 protocol://host/pathname), variables, security, bindings;
    • channels with address, parameters (2.x schema or 3.0 enum/default/examples, location), messages, servers;
    • operations with action: 'send' | 'receive' from the application's side — 2.x subscribe → send, publish → receive; 3.0 as written; summary, tags, messages (3.0 defaults to the channel's), security, bindings, reply (3.0 channel/address/messages);
    • messages: headers and payload schemas, 3.0 multi-format payloads, foreign schema languages (Avro…) kept as written, examples, correlation id, content type (or defaultContentType), tags, bindings;
    • message and operation traits applied; $refs followed with the existing resolver; one object per referenced message; warnings for what does not resolve.
  • detectSpecKind, groupAsyncOperations.

Vue

  • AsyncApiReference: header with downloads, navigation (operations with SEND/RECV badges, messages, schemas), servers, operations grouped by tag or channel, channel addresses with {parameters} marked, messages with schemas (OaSchema), examples (given or sampled), bindings, replies; component messages and schemas. en/ru, light/dark from the kit.

Checks

  • 661 tests (10 new for AsyncAPI 2.6 and 3.0)
  • browser check: both versions, send/receive, parameters, $ref payloads, reply, Avro payload, navigation, labels in the page language, dark theme; no page errors
  • docs asyncapi.md in en/ru/de/zh, README

The changeset makes it 1.2.0.

🤖 Generated with Claude Code

loadAsyncApi reads both versions into one shape (servers, channels,
operations as send/receive from the application's side, messages,
replies, bindings, traits); detectSpecKind tells AsyncAPI from OpenAPI.
AsyncApiReference shows a document with the reference's schema view.
Tests, browser check, docs in four languages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@dskripchenko
dskripchenko merged commit 2e236cd into main Oct 30, 2026
6 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant