feat: add support for AsyncAPI 2 and 3 in the split command (#2552)

Author: tibisabau

.changeset/breezy-cougars-tie.md

@@ -0,0 +1,5 @@
+---
+"@redocly/cli": minor
+---
+
+Added support for AsyncAPI v2 and v3 in the split command.

packages/cli/src/commands/split/__tests__/fixtures/asyncapi2.json

@@ -0,0 +1,38 @@
+{
+  "asyncapi": "2.6.0",
+  "info": {
+    "title": "Test AsyncAPI 2",
+    "version": "1.0.0"
+  },
+  "channels": {
+    "user/signedup": {
+      "subscribe": {
+        "message": {
+          "payload": {
+            "type": "object",
+            "properties": {
+              "userId": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "UserSignedUp": {
+        "type": "object",
+        "properties": {
+          "userId": { "type": "string" }
+        }
+      }
+    },
+    "messages": {
+      "UserSignedUpMessage": {
+        "payload": {
+          "$ref": "#/components/schemas/UserSignedUp"
+        }
+      }
+    }
+  }
+}

packages/cli/src/commands/split/__tests__/fixtures/asyncapi3.json

@@ -0,0 +1,42 @@
+{
+  "asyncapi": "3.0.0",
+  "info": {
+    "title": "Test AsyncAPI 3",
+    "version": "1.0.0"
+  },
+  "channels": {
+    "userSignedUp": {
+      "address": "user/signedup",
+      "messages": {
+        "UserSignedUpMessage": {
+          "$ref": "#/components/messages/UserSignedUpMessage"
+        }
+      }
+    }
+  },
+  "operations": {
+    "UserSignedUp": {
+      "action": "send",
+      "channel": {
+        "$ref": "#/channels/userSignedUp"
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "UserSignedUp": {
+        "type": "object",
+        "properties": {
+          "userId": { "type": "string" }
+        }
+      }
+    },
+    "messages": {
+      "UserSignedUpMessage": {
+        "payload": {
+          "$ref": "#/components/schemas/UserSignedUp"
+        }
+      }
+    }
+  }
+}

packages/cli/src/commands/split/__tests__/index.test.ts

@@ -176,4 +176,54 @@ describe('split', () => {
 
     expect(utils.escapeLanguageName).toBeCalledTimes(3);
   });
+
+  it('should split an AsyncAPI 2 file and show the success message', async () => {
+    const filePath = 'packages/cli/src/commands/split/__tests__/fixtures/asyncapi2.json';
+
+    vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+
+    await handleSplit({
+      argv: {
+        api: filePath,
+        outDir: openapiDir,
+        separator: '_',
+      },
+      config: configFixture,
+      version: 'cli-version',
+    });
+
+    expect(vi.mocked(process.stderr.write)).toBeCalledTimes(2);
+    expect(vi.mocked(process.stderr.write).mock.calls[0][0]).toBe(
+      `🪓 Document: ${blue(filePath!)} ${green('is successfully split')}
+    and all related files are saved to the directory: ${blue(openapiDir)} \n`
+    );
+    expect(vi.mocked(process.stderr.write).mock.calls[1][0]).toContain(
+      `${filePath}: split processed in <test>ms`
+    );
+  });
+
+  it('should split an AsyncAPI 3 file and show the success message', async () => {
+    const filePath = 'packages/cli/src/commands/split/__tests__/fixtures/asyncapi3.json';
+
+    vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+
+    await handleSplit({
+      argv: {
+        api: filePath,
+        outDir: openapiDir,
+        separator: '_',
+      },
+      config: configFixture,
+      version: 'cli-version',
+    });
+
+    expect(vi.mocked(process.stderr.write)).toBeCalledTimes(2);
+    expect(vi.mocked(process.stderr.write).mock.calls[0][0]).toBe(
+      `🪓 Document: ${blue(filePath!)} ${green('is successfully split')}
+    and all related files are saved to the directory: ${blue(openapiDir)} \n`
+    );
+    expect(vi.mocked(process.stderr.write).mock.calls[1][0]).toContain(
+      `${filePath}: split processed in <test>ms`
+    );
+  });
 });