Merge lo/asyncapi-v3: Complete AsyncAPI v3 support

- Phase 3: Circular reference tests (direct, indirect, deep)
- Phase 4: Edge case tests (sibling content, name collision, error handling)
- Phase 5: Full traits and bindings support
- Comprehensive test coverage (41 tests total)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: udamir

CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.5.0]
+
+### Added
+
+- **AsyncAPI v3 Support**: Full support for bundling and dereferencing AsyncAPI 3.x documents
+  - New `asyncapi3.ts` rules module with comprehensive reference mapping
+  - Support for AsyncAPI v3's restructured architecture (top-level operations, channel-scoped messages)
+  - Automatic detection of AsyncAPI v3 documents via `asyncapi: 3.0.0` version field
+
+## [0.4.3]
+
+### Features
+- OpenAPI 3.x basic support
+- Swagger 2.x support
+- AsyncAPI 2.x support
+- JSON Schema support
+- Bundle and dereference functionality
+- Circular reference handling with `enableCircular` option
+- Error hooks for unresolved references
+- Sibling content preservation with `ignoreSibling` option

package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-ref-bundler",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "Bundle all external $ref in Json based API document into single document",
   "module": "dist/index.mjs",
   "main": "dist/index.cjs",

src/rules/asyncapi.ts

@@ -1,4 +1,4 @@
-import { DefinitionPointer, RefMapRules } from "../types"
+import type { DefinitionPointer, RefMapRules } from "../types"
 import { schemaRefMap } from "./jsonSchema"
 
 type AsyncApiComponents = "schemas" | "servers" | "serverVariables" | "channels" | "messages" | "securitySchemes" | "parameters" | "correlationIds" | "operationTraits" | "messageTraits" | "serverBindings" | "channelBindings" | "operationBindings" | "messageBindings"

src/rules/asyncapi3.ts

@@ -1,4 +1,4 @@
-import { DefinitionPointer, RefMapRules } from "../types"
+import type { DefinitionPointer, RefMapRules } from "../types"
 import { schemaRefMap } from "./jsonSchema"
 
 /**
@@ -10,7 +10,12 @@ import { schemaRefMap } from "./jsonSchema"
  * - Root-level channels and operations are not hoisted to components
  */
 
-type AsyncApi3Components = "schemas" | "servers" | "channels" | "operations" | "messages" | "securitySchemes" | "serverVariables" | "parameters" | "correlationIds" | "replies" | "replyAddresses" | "externalDocs" | "tags"
+type AsyncApi3Components =
+  | "schemas" | "servers" | "channels" | "operations" | "messages"
+  | "securitySchemes" | "serverVariables" | "parameters" | "correlationIds"
+  | "replies" | "replyAddresses" | "externalDocs" | "tags"
+  | "operationTraits" | "messageTraits"
+  | "serverBindings" | "channelBindings" | "operationBindings" | "messageBindings"
 
 const asyncApi3DefPaths: Record<AsyncApi3Components, DefinitionPointer> = {
   schemas: "/components/schemas",
@@ -26,6 +31,12 @@ const asyncApi3DefPaths: Record<AsyncApi3Components, DefinitionPointer> = {
   replyAddresses: "/components/replyAddresses",
   externalDocs: "/components/externalDocs",
   tags: "/components/tags",
+  operationTraits: "/components/operationTraits",
+  messageTraits: "/components/messageTraits",
+  serverBindings: "/components/serverBindings",
+  channelBindings: "/components/channelBindings",
+  operationBindings: "/components/operationBindings",
+  messageBindings: "/components/messageBindings",
 } as const
 
 const parametersRefMap: RefMapRules = {
@@ -40,14 +51,26 @@ const serversRefMap: RefMapRules = {
     "#": asyncApi3DefPaths.servers,
     "/variables": {
       "/*": { "#": asyncApi3DefPaths.serverVariables }
-    }
+    },
+    "/security": {
+      "/*": { "#": asyncApi3DefPaths.securitySchemes }
+    },
+    "/tags": {
+      "/*": { "#": asyncApi3DefPaths.tags }
+    },
+    "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+    "/bindings": { "#": asyncApi3DefPaths.serverBindings }
   }
 }
 
 const channelMessageRefMap: RefMapRules = {
   "/headers": schemaRefMap(asyncApi3DefPaths.schemas),
   "/correlationId": { "#": asyncApi3DefPaths.correlationIds },
   "/payload": schemaRefMap(asyncApi3DefPaths.schemas),
+  "/traits": {
+    "/*": { "#": asyncApi3DefPaths.messageTraits }
+  },
+  "/bindings": { "#": asyncApi3DefPaths.messageBindings }
 }
 
 const rootChannelsRefMap: RefMapRules = {
@@ -58,7 +81,12 @@ const rootChannelsRefMap: RefMapRules = {
     "/parameters": parametersRefMap,
     "/messages": {
       "/*": channelMessageRefMap
-    }
+    },
+    "/tags": {
+      "/*": { "#": asyncApi3DefPaths.tags }
+    },
+    "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+    "/bindings": { "#": asyncApi3DefPaths.channelBindings }
   }
 }
 
@@ -71,7 +99,12 @@ const componentChannelsRefMap: RefMapRules = {
     "/parameters": parametersRefMap,
     "/messages": {
       "/*": channelMessageRefMap
-    }
+    },
+    "/tags": {
+      "/*": { "#": asyncApi3DefPaths.tags }
+    },
+    "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+    "/bindings": { "#": asyncApi3DefPaths.channelBindings }
   }
 }
 
@@ -85,8 +118,20 @@ const rootOperationsRefMap: RefMapRules = {
       "/channel": {},
       "/messages": {
         "/*": {}
-      }
-    }
+      },
+      "/address": { "#": asyncApi3DefPaths.replyAddresses }
+    },
+    "/security": {
+      "/*": { "#": asyncApi3DefPaths.securitySchemes }
+    },
+    "/traits": {
+      "/*": { "#": asyncApi3DefPaths.operationTraits }
+    },
+    "/tags": {
+      "/*": { "#": asyncApi3DefPaths.tags }
+    },
+    "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+    "/bindings": { "#": asyncApi3DefPaths.operationBindings }
   }
 }
 
@@ -105,8 +150,20 @@ const componentOperationsRefMap: RefMapRules = {
       },
       "/messages": {
         "/*": {}
-      }
-    }
+      },
+      "/address": { "#": asyncApi3DefPaths.replyAddresses }
+    },
+    "/security": {
+      "/*": { "#": asyncApi3DefPaths.securitySchemes }
+    },
+    "/traits": {
+      "/*": { "#": asyncApi3DefPaths.operationTraits }
+    },
+    "/tags": {
+      "/*": { "#": asyncApi3DefPaths.tags }
+    },
+    "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+    "/bindings": { "#": asyncApi3DefPaths.operationBindings }
   }
 }
 
@@ -115,6 +172,10 @@ const componentMessageRefMap: RefMapRules = {
   "/headers": schemaRefMap(asyncApi3DefPaths.schemas),
   "/correlationId": { "#": asyncApi3DefPaths.correlationIds },
   "/payload": schemaRefMap(asyncApi3DefPaths.schemas),
+  "/traits": {
+    "/*": { "#": asyncApi3DefPaths.messageTraits }
+  },
+  "/bindings": { "#": asyncApi3DefPaths.messageBindings }
 }
 
 export const asyncApi3RefMap: RefMapRules = {
@@ -146,7 +207,8 @@ export const asyncApi3RefMap: RefMapRules = {
         },
         "/messages": {
           "/*": {}
-        }
+        },
+        "/address": { "#": asyncApi3DefPaths.replyAddresses }
       }
     },
     "/replyAddresses": {
@@ -160,6 +222,43 @@ export const asyncApi3RefMap: RefMapRules = {
     },
     "/serverVariables": {
       "/*": { "#": asyncApi3DefPaths.serverVariables }
+    },
+    "/operationTraits": {
+      "/*": {
+        "#": asyncApi3DefPaths.operationTraits,
+        "/tags": {
+          "/*": { "#": asyncApi3DefPaths.tags }
+        },
+        "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+        "/bindings": { "#": asyncApi3DefPaths.operationBindings },
+        "/security": {
+          "/*": { "#": asyncApi3DefPaths.securitySchemes }
+        }
+      }
+    },
+    "/messageTraits": {
+      "/*": {
+        "#": asyncApi3DefPaths.messageTraits,
+        "/headers": schemaRefMap(asyncApi3DefPaths.schemas),
+        "/correlationId": { "#": asyncApi3DefPaths.correlationIds },
+        "/tags": {
+          "/*": { "#": asyncApi3DefPaths.tags }
+        },
+        "/externalDocs": { "#": asyncApi3DefPaths.externalDocs },
+        "/bindings": { "#": asyncApi3DefPaths.messageBindings }
+      }
+    },
+    "/serverBindings": {
+      "/*": { "#": asyncApi3DefPaths.serverBindings }
+    },
+    "/channelBindings": {
+      "/*": { "#": asyncApi3DefPaths.channelBindings }
+    },
+    "/operationBindings": {
+      "/*": { "#": asyncApi3DefPaths.operationBindings }
+    },
+    "/messageBindings": {
+      "/*": { "#": asyncApi3DefPaths.messageBindings }
     }
   }
 }