@swagger-api/apidom-parser-adapter-asyncapi-json-2

@swagger-api/apidom-parser-adapter-asyncapi-json-2

@swagger-api/apidom-parser-adapter-asyncapi-json-2 is a parser adapter for following AsyncAPI specification versions defined in JSON format:

• AsyncAPI 2.6.0 specification
• AsyncAPI 2.5.0 specification
• AsyncAPI 2.4.0 specification
• AsyncAPI 2.3.0 specification
• AsyncAPI 2.2.0 specification
• AsyncAPI 2.1.0 specification
• AsyncAPI 2.0.0 specification

Under the hood this adapter uses @swagger-api/apidom-parser-adapter-json to parse a source string into generic ApiDOM in base ApiDOM namespace which is then refracted with AsyncApi 2.x.y Refractors.

Installation

After prerequisites for installing this package are satisfied, you can install it via npm CLI by running the following command:

 $ npm install @swagger-api/apidom-parser-adapter-asyncapi-json-2

Parser adapter API

This parser adapter is fully compatible with parser adapter interface required by @swagger-api/apidom-parser and implements all required properties.

mediaTypes

Defines list of media types that this parser adapter recognizes.

[
  'application/vnd.aai.asyncapi;version=2.0.0',
  'application/vnd.aai.asyncapi;version=2.1.0',
  'application/vnd.aai.asyncapi;version=2.2.0',
  'application/vnd.aai.asyncapi;version=2.3.0',
  'application/vnd.aai.asyncapi;version=2.4.0',
  'application/vnd.aai.asyncapi;version=2.5.0',
  'application/vnd.aai.asyncapi;version=2.6.0',
  'application/vnd.aai.asyncapi+json;version=2.0.0',
  'application/vnd.aai.asyncapi+json;version=2.1.0',
  'application/vnd.aai.asyncapi+json;version=2.2.0',
  'application/vnd.aai.asyncapi+json;version=2.3.0',
  'application/vnd.aai.asyncapi+json;version=2.4.0',
  'application/vnd.aai.asyncapi+json;version=2.5.0',
  'application/vnd.aai.asyncapi+json;version=2.6.0',
]

detect

Detection is based on a regular expression matching required AsyncApi 2.6.0 specification symbols in JSON format.

namespace

This adapter exposes an instance of AsyncApi 2.x.y ApiDOM namespace.

parse

parse function consumes various options as a second argument. Here is a list of these options:

Option	Type	Default	Description
specObj	Object	Specification Object	This specification object drives the JSON AST transformation to AsyncAPI 2.x ApiDOM namespace.
sourceMap	Boolean	false	Indicate whether to generate source maps.
refractorOpts	Object	{}	Refractor options are passed to refractors during refracting phase.

All unrecognized arbitrary options will be ignored.

Usage

This parser adapter can be used directly or indirectly via @swagger-api/apidom-parser.

Direct usage

During direct usage you don't need to provide mediaType as the parse function is already pre-bound with supported media types.

import { parse, detect } from '@swagger-api/apidom-parser-adapter-asyncapi-json-2';

// detecting
await detect('{"asyncapi": "2.0.0"}'); // => true
await detect('{"asyncapi": "2.1.0"}'); // => true
await detect('{"asyncapi": "2.2.0"}'); // => true
await detect('{"asyncapi": "2.3.0"}'); // => true
await detect('{"asyncapi": "2.4.0"}'); // => true
await detect('{"asyncapi": "2.5.0"}'); // => true
await detect('{"asyncapi": "2.6.0"}'); // => true
await detect('test'); // => false

// parsing
const parseResult = await parse('{"asyncapi": "2.6.0"}', { sourceMap: true });

Indirect usage

You can omit the mediaType option here, but please read Word on detect vs mediaTypes before you do so.

import ApiDOMParser from '@swagger-api/apidom-parser';
import * as asyncApiJsonAdapter from '@swagger-api/apidom-parser-adapter-asyncapi-json-2';

const parser = ApiDOMParser();

parser.use(asyncApiJsonAdapter);

const parseResult = await parser.parse('{"asyncapi": "2.6.0"}', { mediaType: asyncApiJsonAdapter.mediaTypes.latest('json') });

Changelog

0.85.0 (2023-11-30)

Bug Fixes

• reference: fix internal/external URL determination for AsyncAPI 2.x (#3453) (3cc0791), closes #3451
• reference: fix internal/external URL determination for OpenAPI 2.0 (#3454) (c720584), closes #3451
• reference: fix internal/external URL determination for OpenAPI 3.0.x (#3455) (bac4850), closes #3451
• reference: fix internal/extrernal URL determ for OpenAPI 3.1.0 (#3459) (2215480), closes #3451
• reference: lazy fetch URLs only when needed (#3464) (222e3f0), closes #3451

Features

• ls: add initial support for OpenAPI 2.0 (#3470) (e47be92), closes #3103 #3466
• ns-workflows-1: add support for Components Object (#3456) (14dd260), closes #3392
• reference: add OpenAPI 2.0 resolve strategy (#3465) (8d968ae), closes #3101