@amqp-contract/asyncapi 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Benoit Travers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @amqp-contract/asyncapi
+
+AsyncAPI 3.0.0 specification generator for amqp-contract.
+
+## Installation
+
+```bash
+pnpm add @amqp-contract/asyncapi
+```
+
+## Usage
+
+```typescript
+import { generateAsyncAPI } from '@amqp-contract/asyncapi';
+import { contract } from './contract';
+
+// Generate AsyncAPI specification
+const asyncAPISpec = generateAsyncAPI(contract, {
+  info: {
+    title: 'My AMQP API',
+    version: '1.0.0',
+    description: 'Type-safe AMQP messaging API',
+  },
+  servers: {
+    development: {
+      host: 'localhost:5672',
+      protocol: 'amqp',
+      description: 'Development RabbitMQ server',
+    },
+    production: {
+      host: 'rabbitmq.example.com:5672',
+      protocol: 'amqp',
+      description: 'Production RabbitMQ server',
+    },
+  },
+});
+
+// Output as JSON
+console.log(JSON.stringify(asyncAPISpec, null, 2));
+
+// Or write to file
+import { writeFileSync } from 'fs';
+writeFileSync('asyncapi.json', JSON.stringify(asyncAPISpec, null, 2));
+```
+
+## API
+
+### `generateAsyncAPI(contract, options)`
+
+Generate an AsyncAPI 3.0.0 specification from an AMQP contract.
+
+**Parameters:**
+- `contract`: The AMQP contract definition
+- `options`: Configuration options
+  - `info`: API information (title, version, description, etc.)
+  - `servers`: Server configurations (optional)
+
+**Returns:** AsyncAPI 3.0.0 document
+
+## Features
+
+- ✅ Full AsyncAPI 3.0.0 support
+- ✅ Channels from exchanges and queues
+- ✅ Operations for publishers and consumers
+- ✅ Message schemas from Zod schemas
+- ✅ AMQP protocol bindings
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,111 @@
+
+//#region src/schema-converter.ts
+/**
+* Convert a Standard Schema to JSON Schema (AsyncAPI format)
+*
+* This is a basic converter that returns a generic object schema.
+* Users should provide their own schema-to-JSON-Schema converter function
+* specific to their schema library.
+*
+* For Zod users, import and use zodToJsonSchema from @amqp-contract/zod
+*
+* @example
+* ```ts
+* import { zodToJsonSchema } from '@amqp-contract/zod';
+* import { generateAsyncAPI } from '@amqp-contract/asyncapi';
+*
+* // Use zodToJsonSchema for converting Zod schemas
+* const jsonSchema = zodToJsonSchema(zodSchema);
+* ```
+*/
+function standardSchemaToJsonSchema(_schema) {
+	return { type: "object" };
+}
+
+//#endregion
+//#region src/generator.ts
+/**
+* Generate AsyncAPI 3.0.0 specification from AMQP contract
+*/
+function generateAsyncAPI(contract, options) {
+	const channels = {};
+	const operations = {};
+	const messages = {};
+	if (contract.queues) for (const [queueName, queue] of Object.entries(contract.queues)) {
+		const binding = { amqp: {
+			is: "queue",
+			queue: { name: queue.name }
+		} };
+		if (queue.durable !== void 0) binding.amqp.queue.durable = queue.durable;
+		if (queue.exclusive !== void 0) binding.amqp.queue.exclusive = queue.exclusive;
+		if (queue.autoDelete !== void 0) binding.amqp.queue.autoDelete = queue.autoDelete;
+		channels[queueName] = {
+			address: queue.name,
+			description: `Queue: ${queue.name}`,
+			bindings: binding
+		};
+	}
+	if (contract.exchanges) for (const [exchangeName, exchange] of Object.entries(contract.exchanges)) {
+		const binding = { amqp: {
+			is: "routingKey",
+			exchange: {
+				name: exchange.name,
+				type: exchange.type
+			}
+		} };
+		if (exchange.durable !== void 0) binding.amqp.exchange.durable = exchange.durable;
+		if (exchange.autoDelete !== void 0) binding.amqp.exchange.autoDelete = exchange.autoDelete;
+		channels[exchangeName] = {
+			address: exchange.name,
+			description: `Exchange: ${exchange.name} (${exchange.type})`,
+			bindings: binding
+		};
+	}
+	if (contract.publishers) for (const [publisherName, publisher] of Object.entries(contract.publishers)) {
+		const messageName = `${publisherName}Message`;
+		messages[messageName] = {
+			name: messageName,
+			title: `${publisherName} message`,
+			contentType: "application/json",
+			payload: standardSchemaToJsonSchema(publisher.message)
+		};
+		operations[publisherName] = {
+			action: "send",
+			channel: { $ref: `#/channels/${publisher.exchange}` },
+			messages: [{ $ref: `#/components/messages/${messageName}` }],
+			description: `Publish message to ${publisher.exchange}`
+		};
+	}
+	if (contract.consumers) for (const [consumerName, consumer] of Object.entries(contract.consumers)) {
+		const messageName = `${consumerName}Message`;
+		messages[messageName] = {
+			name: messageName,
+			title: `${consumerName} message`,
+			contentType: "application/json",
+			payload: standardSchemaToJsonSchema(consumer.message)
+		};
+		operations[consumerName] = {
+			action: "receive",
+			channel: { $ref: `#/channels/${consumer.queue}` },
+			messages: [{ $ref: `#/components/messages/${messageName}` }],
+			description: `Consume message from ${consumer.queue}`
+		};
+	}
+	const result = {
+		asyncapi: "3.0.0",
+		info: {
+			title: options.info.title ?? "AMQP Contract API",
+			version: options.info.version ?? "1.0.0",
+			...options.info
+		},
+		channels,
+		operations,
+		components: { messages }
+	};
+	if (options.servers) result.servers = options.servers;
+	return result;
+}
+
+//#endregion
+exports.generateAsyncAPI = generateAsyncAPI;
+exports.standardSchemaToJsonSchema = standardSchemaToJsonSchema;

package/dist/index.d.cts

@@ -0,0 +1,136 @@
+import { ContractDefinition } from "@amqp-contract/contract";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/generator.d.ts
+/**
+ * AsyncAPI 3.0.0 Specification
+ */
+interface AsyncAPIDocument {
+  asyncapi: "3.0.0";
+  info: AsyncAPIInfo;
+  servers?: Record<string, AsyncAPIServer>;
+  channels?: Record<string, AsyncAPIChannel>;
+  operations?: Record<string, AsyncAPIOperation>;
+  components?: AsyncAPIComponents;
+}
+interface AsyncAPIInfo {
+  title: string;
+  version: string;
+  description?: string;
+  termsOfService?: string;
+  contact?: {
+    name?: string;
+    url?: string;
+    email?: string;
+  };
+  license?: {
+    name: string;
+    url?: string;
+  };
+}
+interface AsyncAPIServer {
+  host: string;
+  protocol: string;
+  description?: string;
+  variables?: Record<string, {
+    default: string;
+    description?: string;
+  }>;
+}
+interface AsyncAPIChannel {
+  address: string;
+  messages?: Record<string, AsyncAPIMessageRef>;
+  description?: string;
+  bindings?: {
+    amqp?: {
+      is: "queue" | "routingKey";
+      queue?: {
+        name: string;
+        durable?: boolean;
+        exclusive?: boolean;
+        autoDelete?: boolean;
+      };
+      exchange?: {
+        name: string;
+        type: "topic" | "direct" | "fanout" | "headers";
+        durable?: boolean;
+        autoDelete?: boolean;
+      };
+    };
+  };
+}
+interface AsyncAPIOperation {
+  action: "send" | "receive";
+  channel: AsyncAPIRef;
+  messages?: AsyncAPIMessageRef[];
+  description?: string;
+}
+interface AsyncAPIMessageRef {
+  $ref?: string;
+  payload?: AsyncAPISchema;
+  contentType?: string;
+  name?: string;
+  title?: string;
+  summary?: string;
+  description?: string;
+}
+interface AsyncAPISchema {
+  type?: string;
+  properties?: Record<string, AsyncAPISchema>;
+  required?: string[];
+  items?: AsyncAPISchema;
+  $ref?: string;
+  description?: string;
+  format?: string;
+  minimum?: number;
+  maximum?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  enum?: unknown[];
+}
+interface AsyncAPIRef {
+  $ref: string;
+}
+interface AsyncAPIComponents {
+  messages?: Record<string, AsyncAPIMessageRef>;
+  schemas?: Record<string, AsyncAPISchema>;
+}
+/**
+ * Options for generating AsyncAPI specification
+ */
+interface GenerateAsyncAPIOptions {
+  info: Omit<AsyncAPIInfo, "title" | "version"> & {
+    title?: string;
+    version?: string;
+  };
+  servers?: Record<string, AsyncAPIServer>;
+}
+/**
+ * Generate AsyncAPI 3.0.0 specification from AMQP contract
+ */
+declare function generateAsyncAPI(contract: ContractDefinition, options: GenerateAsyncAPIOptions): AsyncAPIDocument;
+//#endregion
+//#region src/schema-converter.d.ts
+/**
+ * Convert a Standard Schema to JSON Schema (AsyncAPI format)
+ *
+ * This is a basic converter that returns a generic object schema.
+ * Users should provide their own schema-to-JSON-Schema converter function
+ * specific to their schema library.
+ *
+ * For Zod users, import and use zodToJsonSchema from @amqp-contract/zod
+ *
+ * @example
+ * ```ts
+ * import { zodToJsonSchema } from '@amqp-contract/zod';
+ * import { generateAsyncAPI } from '@amqp-contract/asyncapi';
+ *
+ * // Use zodToJsonSchema for converting Zod schemas
+ * const jsonSchema = zodToJsonSchema(zodSchema);
+ * ```
+ */
+declare function standardSchemaToJsonSchema(_schema: StandardSchemaV1): AsyncAPISchema;
+//#endregion
+export { type AsyncAPIChannel, type AsyncAPIComponents, type AsyncAPIDocument, type AsyncAPIInfo, type AsyncAPIMessageRef, type AsyncAPIOperation, type AsyncAPISchema, type AsyncAPIServer, type GenerateAsyncAPIOptions, generateAsyncAPI, standardSchemaToJsonSchema };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/generator.ts","../src/schema-converter.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMiB,UAAA,gBAAA,CAAgB;EAEzB,QAAA,EAAA,OAAA;EACmB,IAAA,EADnB,YACmB;EAAf,OAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAe,cAAf,CAAA;EACgB,QAAA,CAAA,EAAf,MAAe,CAAA,MAAA,EAAA,eAAA,CAAA;EAAf,UAAA,CAAA,EACE,MADF,CAAA,MAAA,EACiB,iBADjB,CAAA;EACiB,UAAA,CAAA,EACf,kBADe;;AACf,UAGE,YAAA,CAHF;EAAkB,KAAA,EAAA,MAAA;EAGhB,OAAA,EAAA,MAAY;EAgBZ,WAAA,CAAA,EAAA,MAAc;EAOd,cAAA,CAAA,EAAA,MAAe;EAuBf,OAAA,CAAA,EAAA;IAOA,IAAA,CAAA,EAAA,MAAA;IAUA,GAAA,CAAA,EAAA,MAAA;IAEa,KAAA,CAAA,EAAA,MAAA;EAAf,CAAA;EAEL,OAAA,CAAA,EAAA;IAAc,IAAA,EAAA,MAAA;IAYd,GAAA,CAAA,EAAA,MAAW;EAIJ,CAAA;;AACJ,UApEI,cAAA,CAoEJ;EACc,IAAA,EAAA,MAAA;EAAf,QAAA,EAAA,MAAA;EAAM,WAAA,CAAA,EAAA,MAAA;EAMD,SAAA,CAAA,EAvEH,MAuEG,CAAA,MAAA,EAAuB;IAC3B,OAAA,EAAA,MAAA;IAAL,WAAA,CAAA,EAAA,MAAA;EAImB,CAAA,CAAA;;AAAT,UAzED,eAAA,CAyEC;EAMF,OAAA,EAAA,MAAA;EACJ,QAAA,CAAA,EA9EC,MA8ED,CAAA,MAAA,EA9EgB,kBA8EhB,CAAA;EACD,WAAA,CAAA,EAAA,MAAA;EACR,QAAA,CAAA,EAAA;IAAgB,IAAA,CAAA,EAAA;;;;QCnGH,OAAA,CAAA,EAAA,OAA0B;;;;;;;;;;;;;UDwCzB,iBAAA;;WAEN;aACE;;;UAII,kBAAA;;YAEL;;;;;;;UAQK,cAAA;;eAEF,eAAe;;UAEpB;;;;;;;;;;;UAYA,WAAA;;;UAIO,kBAAA;aACJ,eAAe;YAChB,eAAe;;;;;UAMV,uBAAA;QACT,KAAK;;;;YAID,eAAe;;;;;iBAMX,gBAAA,WACJ,6BACD,0BACR;;;;;AAlHH;;;;;;;;;;AASA;AAgBA;AAOA;AAuBA;AAOA;AAUA;AAE8B,iBC3Dd,0BAAA,CD2Dc,OAAA,EC3DsB,gBD2DtB,CAAA,EC3DyC,cD2DzC"}

package/dist/index.d.mts

@@ -0,0 +1,136 @@
+import { ContractDefinition } from "@amqp-contract/contract";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/generator.d.ts
+/**
+ * AsyncAPI 3.0.0 Specification
+ */
+interface AsyncAPIDocument {
+  asyncapi: "3.0.0";
+  info: AsyncAPIInfo;
+  servers?: Record<string, AsyncAPIServer>;
+  channels?: Record<string, AsyncAPIChannel>;
+  operations?: Record<string, AsyncAPIOperation>;
+  components?: AsyncAPIComponents;
+}
+interface AsyncAPIInfo {
+  title: string;
+  version: string;
+  description?: string;
+  termsOfService?: string;
+  contact?: {
+    name?: string;
+    url?: string;
+    email?: string;
+  };
+  license?: {
+    name: string;
+    url?: string;
+  };
+}
+interface AsyncAPIServer {
+  host: string;
+  protocol: string;
+  description?: string;
+  variables?: Record<string, {
+    default: string;
+    description?: string;
+  }>;
+}
+interface AsyncAPIChannel {
+  address: string;
+  messages?: Record<string, AsyncAPIMessageRef>;
+  description?: string;
+  bindings?: {
+    amqp?: {
+      is: "queue" | "routingKey";
+      queue?: {
+        name: string;
+        durable?: boolean;
+        exclusive?: boolean;
+        autoDelete?: boolean;
+      };
+      exchange?: {
+        name: string;
+        type: "topic" | "direct" | "fanout" | "headers";
+        durable?: boolean;
+        autoDelete?: boolean;
+      };
+    };
+  };
+}
+interface AsyncAPIOperation {
+  action: "send" | "receive";
+  channel: AsyncAPIRef;
+  messages?: AsyncAPIMessageRef[];
+  description?: string;
+}
+interface AsyncAPIMessageRef {
+  $ref?: string;
+  payload?: AsyncAPISchema;
+  contentType?: string;
+  name?: string;
+  title?: string;
+  summary?: string;
+  description?: string;
+}
+interface AsyncAPISchema {
+  type?: string;
+  properties?: Record<string, AsyncAPISchema>;
+  required?: string[];
+  items?: AsyncAPISchema;
+  $ref?: string;
+  description?: string;
+  format?: string;
+  minimum?: number;
+  maximum?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  enum?: unknown[];
+}
+interface AsyncAPIRef {
+  $ref: string;
+}
+interface AsyncAPIComponents {
+  messages?: Record<string, AsyncAPIMessageRef>;
+  schemas?: Record<string, AsyncAPISchema>;
+}
+/**
+ * Options for generating AsyncAPI specification
+ */
+interface GenerateAsyncAPIOptions {
+  info: Omit<AsyncAPIInfo, "title" | "version"> & {
+    title?: string;
+    version?: string;
+  };
+  servers?: Record<string, AsyncAPIServer>;
+}
+/**
+ * Generate AsyncAPI 3.0.0 specification from AMQP contract
+ */
+declare function generateAsyncAPI(contract: ContractDefinition, options: GenerateAsyncAPIOptions): AsyncAPIDocument;
+//#endregion
+//#region src/schema-converter.d.ts
+/**
+ * Convert a Standard Schema to JSON Schema (AsyncAPI format)
+ *
+ * This is a basic converter that returns a generic object schema.
+ * Users should provide their own schema-to-JSON-Schema converter function
+ * specific to their schema library.
+ *
+ * For Zod users, import and use zodToJsonSchema from @amqp-contract/zod
+ *
+ * @example
+ * ```ts
+ * import { zodToJsonSchema } from '@amqp-contract/zod';
+ * import { generateAsyncAPI } from '@amqp-contract/asyncapi';
+ *
+ * // Use zodToJsonSchema for converting Zod schemas
+ * const jsonSchema = zodToJsonSchema(zodSchema);
+ * ```
+ */
+declare function standardSchemaToJsonSchema(_schema: StandardSchemaV1): AsyncAPISchema;
+//#endregion
+export { type AsyncAPIChannel, type AsyncAPIComponents, type AsyncAPIDocument, type AsyncAPIInfo, type AsyncAPIMessageRef, type AsyncAPIOperation, type AsyncAPISchema, type AsyncAPIServer, type GenerateAsyncAPIOptions, generateAsyncAPI, standardSchemaToJsonSchema };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/generator.ts","../src/schema-converter.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMiB,UAAA,gBAAA,CAAgB;EAEzB,QAAA,EAAA,OAAA;EACmB,IAAA,EADnB,YACmB;EAAf,OAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAe,cAAf,CAAA;EACgB,QAAA,CAAA,EAAf,MAAe,CAAA,MAAA,EAAA,eAAA,CAAA;EAAf,UAAA,CAAA,EACE,MADF,CAAA,MAAA,EACiB,iBADjB,CAAA;EACiB,UAAA,CAAA,EACf,kBADe;;AACf,UAGE,YAAA,CAHF;EAAkB,KAAA,EAAA,MAAA;EAGhB,OAAA,EAAA,MAAY;EAgBZ,WAAA,CAAA,EAAA,MAAc;EAOd,cAAA,CAAA,EAAA,MAAe;EAuBf,OAAA,CAAA,EAAA;IAOA,IAAA,CAAA,EAAA,MAAA;IAUA,GAAA,CAAA,EAAA,MAAA;IAEa,KAAA,CAAA,EAAA,MAAA;EAAf,CAAA;EAEL,OAAA,CAAA,EAAA;IAAc,IAAA,EAAA,MAAA;IAYd,GAAA,CAAA,EAAA,MAAW;EAIJ,CAAA;;AACJ,UApEI,cAAA,CAoEJ;EACc,IAAA,EAAA,MAAA;EAAf,QAAA,EAAA,MAAA;EAAM,WAAA,CAAA,EAAA,MAAA;EAMD,SAAA,CAAA,EAvEH,MAuEG,CAAA,MAAA,EAAuB;IAC3B,OAAA,EAAA,MAAA;IAAL,WAAA,CAAA,EAAA,MAAA;EAImB,CAAA,CAAA;;AAAT,UAzED,eAAA,CAyEC;EAMF,OAAA,EAAA,MAAA;EACJ,QAAA,CAAA,EA9EC,MA8ED,CAAA,MAAA,EA9EgB,kBA8EhB,CAAA;EACD,WAAA,CAAA,EAAA,MAAA;EACR,QAAA,CAAA,EAAA;IAAgB,IAAA,CAAA,EAAA;;;;QCnGH,OAAA,CAAA,EAAA,OAA0B;;;;;;;;;;;;;UDwCzB,iBAAA;;WAEN;aACE;;;UAII,kBAAA;;YAEL;;;;;;;UAQK,cAAA;;eAEF,eAAe;;UAEpB;;;;;;;;;;;UAYA,WAAA;;;UAIO,kBAAA;aACJ,eAAe;YAChB,eAAe;;;;;UAMV,uBAAA;QACT,KAAK;;;;YAID,eAAe;;;;;iBAMX,gBAAA,WACJ,6BACD,0BACR;;;;;AAlHH;;;;;;;;;;AASA;AAgBA;AAOA;AAuBA;AAOA;AAUA;AAE8B,iBC3Dd,0BAAA,CD2Dc,OAAA,EC3DsB,gBD2DtB,CAAA,EC3DyC,cD2DzC"}

package/dist/index.mjs

@@ -0,0 +1,110 @@
+//#region src/schema-converter.ts
+/**
+* Convert a Standard Schema to JSON Schema (AsyncAPI format)
+*
+* This is a basic converter that returns a generic object schema.
+* Users should provide their own schema-to-JSON-Schema converter function
+* specific to their schema library.
+*
+* For Zod users, import and use zodToJsonSchema from @amqp-contract/zod
+*
+* @example
+* ```ts
+* import { zodToJsonSchema } from '@amqp-contract/zod';
+* import { generateAsyncAPI } from '@amqp-contract/asyncapi';
+*
+* // Use zodToJsonSchema for converting Zod schemas
+* const jsonSchema = zodToJsonSchema(zodSchema);
+* ```
+*/
+function standardSchemaToJsonSchema(_schema) {
+	return { type: "object" };
+}
+
+//#endregion
+//#region src/generator.ts
+/**
+* Generate AsyncAPI 3.0.0 specification from AMQP contract
+*/
+function generateAsyncAPI(contract, options) {
+	const channels = {};
+	const operations = {};
+	const messages = {};
+	if (contract.queues) for (const [queueName, queue] of Object.entries(contract.queues)) {
+		const binding = { amqp: {
+			is: "queue",
+			queue: { name: queue.name }
+		} };
+		if (queue.durable !== void 0) binding.amqp.queue.durable = queue.durable;
+		if (queue.exclusive !== void 0) binding.amqp.queue.exclusive = queue.exclusive;
+		if (queue.autoDelete !== void 0) binding.amqp.queue.autoDelete = queue.autoDelete;
+		channels[queueName] = {
+			address: queue.name,
+			description: `Queue: ${queue.name}`,
+			bindings: binding
+		};
+	}
+	if (contract.exchanges) for (const [exchangeName, exchange] of Object.entries(contract.exchanges)) {
+		const binding = { amqp: {
+			is: "routingKey",
+			exchange: {
+				name: exchange.name,
+				type: exchange.type
+			}
+		} };
+		if (exchange.durable !== void 0) binding.amqp.exchange.durable = exchange.durable;
+		if (exchange.autoDelete !== void 0) binding.amqp.exchange.autoDelete = exchange.autoDelete;
+		channels[exchangeName] = {
+			address: exchange.name,
+			description: `Exchange: ${exchange.name} (${exchange.type})`,
+			bindings: binding
+		};
+	}
+	if (contract.publishers) for (const [publisherName, publisher] of Object.entries(contract.publishers)) {
+		const messageName = `${publisherName}Message`;
+		messages[messageName] = {
+			name: messageName,
+			title: `${publisherName} message`,
+			contentType: "application/json",
+			payload: standardSchemaToJsonSchema(publisher.message)
+		};
+		operations[publisherName] = {
+			action: "send",
+			channel: { $ref: `#/channels/${publisher.exchange}` },
+			messages: [{ $ref: `#/components/messages/${messageName}` }],
+			description: `Publish message to ${publisher.exchange}`
+		};
+	}
+	if (contract.consumers) for (const [consumerName, consumer] of Object.entries(contract.consumers)) {
+		const messageName = `${consumerName}Message`;
+		messages[messageName] = {
+			name: messageName,
+			title: `${consumerName} message`,
+			contentType: "application/json",
+			payload: standardSchemaToJsonSchema(consumer.message)
+		};
+		operations[consumerName] = {
+			action: "receive",
+			channel: { $ref: `#/channels/${consumer.queue}` },
+			messages: [{ $ref: `#/components/messages/${messageName}` }],
+			description: `Consume message from ${consumer.queue}`
+		};
+	}
+	const result = {
+		asyncapi: "3.0.0",
+		info: {
+			title: options.info.title ?? "AMQP Contract API",
+			version: options.info.version ?? "1.0.0",
+			...options.info
+		},
+		channels,
+		operations,
+		components: { messages }
+	};
+	if (options.servers) result.servers = options.servers;
+	return result;
+}
+
+//#endregion
+export { generateAsyncAPI, standardSchemaToJsonSchema };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["channels: Record<string, AsyncAPIChannel>","operations: Record<string, AsyncAPIOperation>","messages: Record<string, AsyncAPIMessageRef>","binding: {\n        amqp?: {\n          is: \"queue\";\n          queue?: {\n            name: string;\n            durable?: boolean;\n            exclusive?: boolean;\n            autoDelete?: boolean;\n          };\n        };\n      }","binding: {\n        amqp?: {\n          is: \"routingKey\";\n          exchange?: {\n            name: string;\n            type: \"topic\" | \"direct\" | \"fanout\" | \"headers\";\n            durable?: boolean;\n            autoDelete?: boolean;\n          };\n        };\n      }","result: AsyncAPIDocument"],"sources":["../src/schema-converter.ts","../src/generator.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { AsyncAPISchema } from \"./generator.js\";\n\n/**\n * Convert a Standard Schema to JSON Schema (AsyncAPI format)\n *\n * This is a basic converter that returns a generic object schema.\n * Users should provide their own schema-to-JSON-Schema converter function\n * specific to their schema library.\n *\n * For Zod users, import and use zodToJsonSchema from @amqp-contract/zod\n *\n * @example\n * ```ts\n * import { zodToJsonSchema } from '@amqp-contract/zod';\n * import { generateAsyncAPI } from '@amqp-contract/asyncapi';\n *\n * // Use zodToJsonSchema for converting Zod schemas\n * const jsonSchema = zodToJsonSchema(zodSchema);\n * ```\n */\nexport function standardSchemaToJsonSchema(_schema: StandardSchemaV1): AsyncAPISchema {\n  // Basic fallback - returns a generic object schema\n  // Users should provide their own converter for better results\n  return { type: \"object\" };\n}\n","import type { ContractDefinition } from \"@amqp-contract/contract\";\nimport { standardSchemaToJsonSchema } from \"./schema-converter.js\";\n\n/**\n * AsyncAPI 3.0.0 Specification\n */\nexport interface AsyncAPIDocument {\n  asyncapi: \"3.0.0\";\n  info: AsyncAPIInfo;\n  servers?: Record<string, AsyncAPIServer>;\n  channels?: Record<string, AsyncAPIChannel>;\n  operations?: Record<string, AsyncAPIOperation>;\n  components?: AsyncAPIComponents;\n}\n\nexport interface AsyncAPIInfo {\n  title: string;\n  version: string;\n  description?: string;\n  termsOfService?: string;\n  contact?: {\n    name?: string;\n    url?: string;\n    email?: string;\n  };\n  license?: {\n    name: string;\n    url?: string;\n  };\n}\n\nexport interface AsyncAPIServer {\n  host: string;\n  protocol: string;\n  description?: string;\n  variables?: Record<string, { default: string; description?: string }>;\n}\n\nexport interface AsyncAPIChannel {\n  address: string;\n  messages?: Record<string, AsyncAPIMessageRef>;\n  description?: string;\n  bindings?: {\n    amqp?: {\n      is: \"queue\" | \"routingKey\";\n      queue?: {\n        name: string;\n        durable?: boolean;\n        exclusive?: boolean;\n        autoDelete?: boolean;\n      };\n      exchange?: {\n        name: string;\n        type: \"topic\" | \"direct\" | \"fanout\" | \"headers\";\n        durable?: boolean;\n        autoDelete?: boolean;\n      };\n    };\n  };\n}\n\nexport interface AsyncAPIOperation {\n  action: \"send\" | \"receive\";\n  channel: AsyncAPIRef;\n  messages?: AsyncAPIMessageRef[];\n  description?: string;\n}\n\nexport interface AsyncAPIMessageRef {\n  $ref?: string;\n  payload?: AsyncAPISchema;\n  contentType?: string;\n  name?: string;\n  title?: string;\n  summary?: string;\n  description?: string;\n}\n\nexport interface AsyncAPISchema {\n  type?: string;\n  properties?: Record<string, AsyncAPISchema>;\n  required?: string[];\n  items?: AsyncAPISchema;\n  $ref?: string;\n  description?: string;\n  format?: string;\n  minimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  enum?: unknown[];\n}\n\ninterface AsyncAPIRef {\n  $ref: string;\n}\n\nexport interface AsyncAPIComponents {\n  messages?: Record<string, AsyncAPIMessageRef>;\n  schemas?: Record<string, AsyncAPISchema>;\n}\n\n/**\n * Options for generating AsyncAPI specification\n */\nexport interface GenerateAsyncAPIOptions {\n  info: Omit<AsyncAPIInfo, \"title\" | \"version\"> & {\n    title?: string;\n    version?: string;\n  };\n  servers?: Record<string, AsyncAPIServer>;\n}\n\n/**\n * Generate AsyncAPI 3.0.0 specification from AMQP contract\n */\nexport function generateAsyncAPI(\n  contract: ContractDefinition,\n  options: GenerateAsyncAPIOptions,\n): AsyncAPIDocument {\n  const channels: Record<string, AsyncAPIChannel> = {};\n  const operations: Record<string, AsyncAPIOperation> = {};\n  const messages: Record<string, AsyncAPIMessageRef> = {};\n\n  // Generate channels from queues\n  if (contract.queues) {\n    for (const [queueName, queue] of Object.entries(contract.queues)) {\n      const binding: {\n        amqp?: {\n          is: \"queue\";\n          queue?: {\n            name: string;\n            durable?: boolean;\n            exclusive?: boolean;\n            autoDelete?: boolean;\n          };\n        };\n      } = {\n        amqp: {\n          is: \"queue\",\n          queue: {\n            name: queue.name,\n          },\n        },\n      };\n\n      if (queue.durable !== undefined) {\n        binding.amqp!.queue!.durable = queue.durable;\n      }\n      if (queue.exclusive !== undefined) {\n        binding.amqp!.queue!.exclusive = queue.exclusive;\n      }\n      if (queue.autoDelete !== undefined) {\n        binding.amqp!.queue!.autoDelete = queue.autoDelete;\n      }\n\n      channels[queueName] = {\n        address: queue.name,\n        description: `Queue: ${queue.name}`,\n        bindings: binding,\n      };\n    }\n  }\n\n  // Generate channels from exchanges\n  if (contract.exchanges) {\n    for (const [exchangeName, exchange] of Object.entries(contract.exchanges)) {\n      const binding: {\n        amqp?: {\n          is: \"routingKey\";\n          exchange?: {\n            name: string;\n            type: \"topic\" | \"direct\" | \"fanout\" | \"headers\";\n            durable?: boolean;\n            autoDelete?: boolean;\n          };\n        };\n      } = {\n        amqp: {\n          is: \"routingKey\",\n          exchange: {\n            name: exchange.name,\n            type: exchange.type,\n          },\n        },\n      };\n\n      if (exchange.durable !== undefined) {\n        binding.amqp!.exchange!.durable = exchange.durable;\n      }\n      if (exchange.autoDelete !== undefined) {\n        binding.amqp!.exchange!.autoDelete = exchange.autoDelete;\n      }\n\n      channels[exchangeName] = {\n        address: exchange.name,\n        description: `Exchange: ${exchange.name} (${exchange.type})`,\n        bindings: binding,\n      };\n    }\n  }\n\n  // Generate operations from publishers\n  if (contract.publishers) {\n    for (const [publisherName, publisher] of Object.entries(contract.publishers)) {\n      const messageName = `${publisherName}Message`;\n\n      messages[messageName] = {\n        name: messageName,\n        title: `${publisherName} message`,\n        contentType: \"application/json\",\n        payload: standardSchemaToJsonSchema(publisher.message),\n      };\n\n      operations[publisherName] = {\n        action: \"send\",\n        channel: { $ref: `#/channels/${publisher.exchange}` },\n        messages: [{ $ref: `#/components/messages/${messageName}` }],\n        description: `Publish message to ${publisher.exchange}`,\n      };\n    }\n  }\n\n  // Generate operations from consumers\n  if (contract.consumers) {\n    for (const [consumerName, consumer] of Object.entries(contract.consumers)) {\n      const messageName = `${consumerName}Message`;\n\n      messages[messageName] = {\n        name: messageName,\n        title: `${consumerName} message`,\n        contentType: \"application/json\",\n        payload: standardSchemaToJsonSchema(consumer.message),\n      };\n\n      operations[consumerName] = {\n        action: \"receive\",\n        channel: { $ref: `#/channels/${consumer.queue}` },\n        messages: [{ $ref: `#/components/messages/${messageName}` }],\n        description: `Consume message from ${consumer.queue}`,\n      };\n    }\n  }\n\n  const result: AsyncAPIDocument = {\n    asyncapi: \"3.0.0\",\n    info: {\n      title: options.info.title ?? \"AMQP Contract API\",\n      version: options.info.version ?? \"1.0.0\",\n      ...options.info,\n    },\n    channels,\n    operations,\n    components: {\n      messages,\n    },\n  };\n\n  if (options.servers) {\n    result.servers = options.servers;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,2BAA2B,SAA2C;AAGpF,QAAO,EAAE,MAAM,UAAU;;;;;;;;AC6F3B,SAAgB,iBACd,UACA,SACkB;CAClB,MAAMA,WAA4C,EAAE;CACpD,MAAMC,aAAgD,EAAE;CACxD,MAAMC,WAA+C,EAAE;AAGvD,KAAI,SAAS,OACX,MAAK,MAAM,CAAC,WAAW,UAAU,OAAO,QAAQ,SAAS,OAAO,EAAE;EAChE,MAAMC,UAUF,EACF,MAAM;GACJ,IAAI;GACJ,OAAO,EACL,MAAM,MAAM,MACb;GACF,EACF;AAED,MAAI,MAAM,YAAY,OACpB,SAAQ,KAAM,MAAO,UAAU,MAAM;AAEvC,MAAI,MAAM,cAAc,OACtB,SAAQ,KAAM,MAAO,YAAY,MAAM;AAEzC,MAAI,MAAM,eAAe,OACvB,SAAQ,KAAM,MAAO,aAAa,MAAM;AAG1C,WAAS,aAAa;GACpB,SAAS,MAAM;GACf,aAAa,UAAU,MAAM;GAC7B,UAAU;GACX;;AAKL,KAAI,SAAS,UACX,MAAK,MAAM,CAAC,cAAc,aAAa,OAAO,QAAQ,SAAS,UAAU,EAAE;EACzE,MAAMC,UAUF,EACF,MAAM;GACJ,IAAI;GACJ,UAAU;IACR,MAAM,SAAS;IACf,MAAM,SAAS;IAChB;GACF,EACF;AAED,MAAI,SAAS,YAAY,OACvB,SAAQ,KAAM,SAAU,UAAU,SAAS;AAE7C,MAAI,SAAS,eAAe,OAC1B,SAAQ,KAAM,SAAU,aAAa,SAAS;AAGhD,WAAS,gBAAgB;GACvB,SAAS,SAAS;GAClB,aAAa,aAAa,SAAS,KAAK,IAAI,SAAS,KAAK;GAC1D,UAAU;GACX;;AAKL,KAAI,SAAS,WACX,MAAK,MAAM,CAAC,eAAe,cAAc,OAAO,QAAQ,SAAS,WAAW,EAAE;EAC5E,MAAM,cAAc,GAAG,cAAc;AAErC,WAAS,eAAe;GACtB,MAAM;GACN,OAAO,GAAG,cAAc;GACxB,aAAa;GACb,SAAS,2BAA2B,UAAU,QAAQ;GACvD;AAED,aAAW,iBAAiB;GAC1B,QAAQ;GACR,SAAS,EAAE,MAAM,cAAc,UAAU,YAAY;GACrD,UAAU,CAAC,EAAE,MAAM,yBAAyB,eAAe,CAAC;GAC5D,aAAa,sBAAsB,UAAU;GAC9C;;AAKL,KAAI,SAAS,UACX,MAAK,MAAM,CAAC,cAAc,aAAa,OAAO,QAAQ,SAAS,UAAU,EAAE;EACzE,MAAM,cAAc,GAAG,aAAa;AAEpC,WAAS,eAAe;GACtB,MAAM;GACN,OAAO,GAAG,aAAa;GACvB,aAAa;GACb,SAAS,2BAA2B,SAAS,QAAQ;GACtD;AAED,aAAW,gBAAgB;GACzB,QAAQ;GACR,SAAS,EAAE,MAAM,cAAc,SAAS,SAAS;GACjD,UAAU,CAAC,EAAE,MAAM,yBAAyB,eAAe,CAAC;GAC5D,aAAa,wBAAwB,SAAS;GAC/C;;CAIL,MAAMC,SAA2B;EAC/B,UAAU;EACV,MAAM;GACJ,OAAO,QAAQ,KAAK,SAAS;GAC7B,SAAS,QAAQ,KAAK,WAAW;GACjC,GAAG,QAAQ;GACZ;EACD;EACA;EACA,YAAY,EACV,UACD;EACF;AAED,KAAI,QAAQ,QACV,QAAO,UAAU,QAAQ;AAG3B,QAAO"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@amqp-contract/asyncapi",
+  "version": "0.0.1",
+  "description": "AsyncAPI specification generator for amqp-contract",
+  "keywords": [
+    "amqp",
+    "typescript",
+    "contract",
+    "asyncapi",
+    "rabbitmq"
+  ],
+  "homepage": "https://github.com/btravers/amqp-contract#readme",
+  "bugs": {
+    "url": "https://github.com/btravers/amqp-contract/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/btravers/amqp-contract.git",
+    "directory": "packages/asyncapi"
+  },
+  "license": "MIT",
+  "author": "Benoit TRAVERS <benoit.travers.fr@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@standard-schema/spec": "1.0.0",
+    "@amqp-contract/contract": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.2",
+    "@vitest/coverage-v8": "4.0.15",
+    "tsdown": "0.17.2",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15",
+    "zod": "4.1.13",
+    "@amqp-contract/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}