@amqp-contract/asyncapi

---

@amqp-contract/asyncapi

Classes

AsyncAPIGenerator

Defined in: index.ts:111

Generator for creating AsyncAPI 3.0 documentation from AMQP contracts.

This class converts contract definitions into AsyncAPI 3.0 specification documents, which can be used for API documentation, code generation, and tooling integration.

Example

import { AsyncAPIGenerator } from '@amqp-contract/asyncapi';
import { defineExchange, defineMessage, defineContract, definePublisher } from '@amqp-contract/contract';
import { zodToJsonSchema } from '@orpc/zod';
import { z } from 'zod';

const ordersExchange = defineExchange('orders');
const orderMessage = defineMessage(z.object({
  orderId: z.string(),
  amount: z.number()
}));

const contract = defineContract({
  publishers: {
    orderCreated: definePublisher(ordersExchange, orderMessage, {
      routingKey: 'order.created'
    })
  }
});

const generator = new AsyncAPIGenerator({
  schemaConverters: [zodToJsonSchema]
});

const asyncapi = await generator.generate(contract, {
  id: 'urn:com:example:order-service',
  info: {
    title: 'Order Service API',
    version: '1.0.0',
    description: 'Async API for order processing'
  },
  servers: {
    production: {
      host: 'rabbitmq.example.com',
      protocol: 'amqp',
      protocolVersion: '0.9.1'
    }
  }
});

Constructors

Constructor

new AsyncAPIGenerator(options?): AsyncAPIGenerator;

Defined in: index.ts:121

Create a new AsyncAPI generator instance.

Parameters

Parameter	Type	Description
options	AsyncAPIGeneratorOptions	Configuration options including schema converters

Returns

AsyncAPIGenerator

Methods

generate()

generate(contract, options): Promise<AsyncAPIObject>;

Defined in: index.ts:155

Generate an AsyncAPI 3.0 document from a contract definition.

Converts AMQP exchanges, queues, publishers, and consumers into AsyncAPI channels, operations, and messages with proper JSON Schema validation definitions.

Parameters

Parameter	Type	Description
contract	ContractDefinition	The AMQP contract definition to convert
options	AsyncAPIGeneratorGenerateOptions	AsyncAPI document metadata (id, info, servers)

Returns

Promise<AsyncAPIObject>

Promise resolving to a complete AsyncAPI 3.0 document

Example

const asyncapi = await generator.generate(contract, {
  id: 'urn:com:example:api',
  info: {
    title: 'My API',
    version: '1.0.0'
  },
  servers: {
    dev: {
      host: 'localhost:5672',
      protocol: 'amqp'
    }
  }
});

Type Aliases

AsyncAPIGeneratorGenerateOptions

type AsyncAPIGeneratorGenerateOptions = Pick<AsyncAPIObject, "info"> & Partial<Pick<AsyncAPIObject, "id" | "servers">>;

Defined in: index.ts:60

Options for generating an AsyncAPI document. These correspond to the top-level AsyncAPI document fields.

---

AsyncAPIGeneratorOptions

type AsyncAPIGeneratorOptions = object;

Defined in: index.ts:35

Options for configuring the AsyncAPI generator.

Example

import { AsyncAPIGenerator } from '@amqp-contract/asyncapi';
import { zodToJsonSchema } from '@orpc/zod';

const generator = new AsyncAPIGenerator({
  schemaConverters: [zodToJsonSchema]
});

Properties

Property	Type	Description	Defined in
failOnMissingConverter?	boolean	If true, the generator throws when a payload schema cannot be converted by any of the configured schemaConverters instead of falling back to a generic { type: "object" } placeholder. Recommended for CI pipelines that depend on the generated spec being faithful (e.g. for codegen). Defaults to false for backwards compatibility.	index.ts:53
logger?	object	Optional logger for warnings during generation (e.g. unmatched schema converters).	index.ts:44
logger.warn	(message) => void	-	index.ts:44
schemaConverters?	ConditionalSchemaConverter[]	Schema converters for transforming validation schemas to JSON Schema. Supports Zod, Valibot, ArkType, and other Standard Schema v1 compatible libraries.	index.ts:40