@asyncapi/cli 2.8.1 → 2.10.0

package/assets/create-glee-app/templates/default/package-lock.json

@@ -5369,9 +5369,9 @@
       "peer": true
     },
     "node_modules/cookie": {
-      "version": "0.4.2",
-      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.4.2.tgz",
-      "integrity": "sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA==",
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
       "engines": {
         "node": ">= 0.6"
       }
@@ -5908,16 +5908,16 @@
       }
     },
     "node_modules/engine.io": {
-      "version": "6.5.5",
-      "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.5.5.tgz",
-      "integrity": "sha512-C5Pn8Wk+1vKBoHghJODM63yk8MvrO9EWZUfkAt5HAqIgPE4/8FF0PEGHXtEd40l223+cE5ABWuPzm38PHFXfMA==",
+      "version": "6.6.2",
+      "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.6.2.tgz",
+      "integrity": "sha512-gmNvsYi9C8iErnZdVcJnvCpSKbWTt1E8+JZo8b+daLninywUWi5NQ5STSHZ9rFjFO7imNcvb8Pc5pe/wMR5xEw==",
       "dependencies": {
         "@types/cookie": "^0.4.1",
         "@types/cors": "^2.8.12",
         "@types/node": ">=10.0.0",
         "accepts": "~1.3.4",
         "base64id": "2.0.0",
-        "cookie": "~0.4.1",
+        "cookie": "~0.7.2",
         "cors": "~2.8.5",
         "debug": "~4.3.1",
         "engine.io-parser": "~5.2.1",
@@ -11794,15 +11794,15 @@
       }
     },
     "node_modules/socket.io": {
-      "version": "4.7.5",
-      "resolved": "https://registry.npmjs.org/socket.io/-/socket.io-4.7.5.tgz",
-      "integrity": "sha512-DmeAkF6cwM9jSfmp6Dr/5/mfMwb5Z5qRrSXLpo3Fq5SqyU8CMF15jIN4ZhfSwu35ksM1qmHZDQ/DK5XTccSTvA==",
+      "version": "4.8.1",
+      "resolved": "https://registry.npmjs.org/socket.io/-/socket.io-4.8.1.tgz",
+      "integrity": "sha512-oZ7iUCxph8WYRHHcjBEc9unw3adt5CmSNlppj/5Q4k2RIrhl8Z5yY2Xr4j9zj0+wzVZ0bxmYoGSzKJnRl6A4yg==",
       "dependencies": {
         "accepts": "~1.3.4",
         "base64id": "~2.0.0",
         "cors": "~2.8.5",
         "debug": "~4.3.2",
-        "engine.io": "~6.5.2",
+        "engine.io": "~6.6.0",
         "socket.io-adapter": "~2.5.2",
         "socket.io-parser": "~4.2.4"
       },

package/assets/create-glee-app/templates/tutorial/package-lock.json

@@ -5366,9 +5366,9 @@
       "peer": true
     },
     "node_modules/cookie": {
-      "version": "0.4.2",
-      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.4.2.tgz",
-      "integrity": "sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA==",
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
       "engines": {
         "node": ">= 0.6"
       }
@@ -5905,16 +5905,16 @@
       }
     },
     "node_modules/engine.io": {
-      "version": "6.5.5",
-      "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.5.5.tgz",
-      "integrity": "sha512-C5Pn8Wk+1vKBoHghJODM63yk8MvrO9EWZUfkAt5HAqIgPE4/8FF0PEGHXtEd40l223+cE5ABWuPzm38PHFXfMA==",
+      "version": "6.6.2",
+      "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.6.2.tgz",
+      "integrity": "sha512-gmNvsYi9C8iErnZdVcJnvCpSKbWTt1E8+JZo8b+daLninywUWi5NQ5STSHZ9rFjFO7imNcvb8Pc5pe/wMR5xEw==",
       "dependencies": {
         "@types/cookie": "^0.4.1",
         "@types/cors": "^2.8.12",
         "@types/node": ">=10.0.0",
         "accepts": "~1.3.4",
         "base64id": "2.0.0",
-        "cookie": "~0.4.1",
+        "cookie": "~0.7.2",
         "cors": "~2.8.5",
         "debug": "~4.3.1",
         "engine.io-parser": "~5.2.1",
@@ -11791,15 +11791,15 @@
       }
     },
     "node_modules/socket.io": {
-      "version": "4.7.5",
-      "resolved": "https://registry.npmjs.org/socket.io/-/socket.io-4.7.5.tgz",
-      "integrity": "sha512-DmeAkF6cwM9jSfmp6Dr/5/mfMwb5Z5qRrSXLpo3Fq5SqyU8CMF15jIN4ZhfSwu35ksM1qmHZDQ/DK5XTccSTvA==",
+      "version": "4.8.0",
+      "resolved": "https://registry.npmjs.org/socket.io/-/socket.io-4.8.0.tgz",
+      "integrity": "sha512-8U6BEgGjQOfGz3HHTYaC/L1GaxDCJ/KM0XTkJly0EhZ5U/du9uNEZy4ZgYzEzIqlx2CMm25CrCqr1ck899eLNA==",
       "dependencies": {
         "accepts": "~1.3.4",
         "base64id": "~2.0.0",
         "cors": "~2.8.5",
         "debug": "~4.3.2",
-        "engine.io": "~6.5.2",
+        "engine.io": "~6.6.0",
         "socket.io-adapter": "~2.5.2",
         "socket.io-parser": "~4.2.4"
       },

package/assets/create-template/templates/default/package-lock.json

@@ -91,11 +91,11 @@
       }
     },
     "node_modules/@asyncapi/parser": {
-      "version": "3.2.2",
-      "resolved": "https://registry.npmjs.org/@asyncapi/parser/-/parser-3.2.2.tgz",
-      "integrity": "sha512-ved4ja3ANs6BcRhWLbK/A7JIhJyMQBYdV1GZwo6Ptf+qBkGIdvV3dt8M4T6TZqtIbUI2NOvmO2YUqtaPWTudgA==",
+      "version": "3.4.0",
+      "resolved": "https://registry.npmjs.org/@asyncapi/parser/-/parser-3.4.0.tgz",
+      "integrity": "sha512-Sxn74oHiZSU6+cVeZy62iPZMFMvKp4jupMFHelSICCMw1qELmUHPvuZSr+ZHDmNGgHcEpzJM5HN02kR7T4g+PQ==",
       "dependencies": {
-        "@asyncapi/specs": "^6.6.0",
+        "@asyncapi/specs": "^6.8.0",
         "@openapi-contrib/openapi-schema-to-json-schema": "~3.2.0",
         "@stoplight/json": "3.21.0",
         "@stoplight/json-ref-readers": "^1.2.2",
@@ -112,14 +112,14 @@
         "ajv-formats": "^2.1.1",
         "avsc": "^5.7.5",
         "js-yaml": "^4.1.0",
-        "jsonpath-plus": "^7.2.0",
+        "jsonpath-plus": "^10.0.0",
         "node-fetch": "2.6.7"
       }
     },
     "node_modules/@asyncapi/specs": {
-      "version": "6.7.1",
-      "resolved": "https://registry.npmjs.org/@asyncapi/specs/-/specs-6.7.1.tgz",
-      "integrity": "sha512-jEaW2vgAwD9GboCdO/TI1zN2k+iowL8YFYwiZwTIr4U4KDmsgo3BLypScl6Jl4+IvY9RdsWE67nuzVX7jooiqQ==",
+      "version": "6.8.0",
+      "resolved": "https://registry.npmjs.org/@asyncapi/specs/-/specs-6.8.0.tgz",
+      "integrity": "sha512-1i6xs8+IOh6U5T7yH+bCMGQBF+m7kP/NpwyAlt++XaDQutoGCgACf24mQBgcDVqDWWoY81evQv+9ABvw0BviVg==",
       "dependencies": {
         "@types/json-schema": "^7.0.11"
       }
@@ -1813,6 +1813,17 @@
         "@jridgewell/sourcemap-codec": "^1.4.14"
       }
     },
+    "node_modules/@jsep-plugin/assignment": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@jsep-plugin/assignment/-/assignment-1.3.0.tgz",
+      "integrity": "sha512-VVgV+CXrhbMI3aSusQyclHkenWSAm95WaiKrMxRFam3JSUiIaQjoMIw2sEs/OX4XifnqeQUN4DYbJjlA8EfktQ==",
+      "engines": {
+        "node": ">= 10.16.0"
+      },
+      "peerDependencies": {
+        "jsep": "^0.4.0||^1.0.0"
+      }
+    },
     "node_modules/@jsep-plugin/regex": {
       "version": "1.0.3",
       "resolved": "https://registry.npmjs.org/@jsep-plugin/regex/-/regex-1.0.3.tgz",
@@ -3344,11 +3355,20 @@
       "integrity": "sha512-o6/yDBYccGvTz1+QFevz6l6OBZ2+fMVu2JZ9CIhzsYRX4mjaK5IyX9eldUdCmga16zlgQxyrj5pt9kzuj2C02w=="
     },
     "node_modules/jsonpath-plus": {
-      "version": "7.2.0",
-      "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-7.2.0.tgz",
-      "integrity": "sha512-zBfiUPM5nD0YZSBT/o/fbCUlCcepMIdP0CJZxM1+KgA4f2T206f6VAg9e7mX35+KlMaIc5qXW34f3BnwJ3w+RA==",
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-10.1.0.tgz",
+      "integrity": "sha512-gHfV1IYqH8uJHYVTs8BJX1XKy2/rR93+f8QQi0xhx95aCiXn1ettYAd5T+7FU6wfqyDoX/wy0pm/fL3jOKJ9Lg==",
+      "dependencies": {
+        "@jsep-plugin/assignment": "^1.2.1",
+        "@jsep-plugin/regex": "^1.0.3",
+        "jsep": "^1.3.9"
+      },
+      "bin": {
+        "jsonpath": "bin/jsonpath-cli.js",
+        "jsonpath-plus": "bin/jsonpath-cli.js"
+      },
       "engines": {
-        "node": ">=12.0.0"
+        "node": ">=18.0.0"
       }
     },
     "node_modules/jsonpointer": {

package/lib/commands/diff.d.ts

@@ -5,7 +5,8 @@ export default class Diff extends Command {
     static flags: {
         'log-diagnostics': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'diagnostics-format': import("@oclif/core/lib/interfaces").OptionFlag<import("@stoplight/spectral-cli/dist/services/config").OutputFormat, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"error" | "warn" | "info" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+        'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"info" | "error" | "warn" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
         format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         type: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;

package/lib/commands/format.d.ts

@@ -0,0 +1,18 @@
+import Command from '../core/base';
+export default class Convert extends Command {
+    static specFile: any;
+    static metricsMetadata: any;
+    static description: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    static args: {
+        'spec-file': import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    private handleConversion;
+    private handleOutput;
+    private removeExtensionFromOutputPath;
+}

package/lib/commands/format.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+const fs_1 = require("fs");
+const core_1 = require("@oclif/core");
+const base_1 = tslib_1.__importDefault(require("../core/base"));
+const SpecificationFile_1 = require("../core/models/SpecificationFile");
+const specification_file_1 = require("../core/errors/specification-file");
+const picocolors_1 = require("picocolors");
+const format_flags_1 = require("../core/flags/format.flags");
+class Convert extends base_1.default {
+    run() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { args, flags } = yield this.parse(Convert);
+            const filePath = args['spec-file'];
+            const outputFileFormat = flags['format'];
+            let convertedFile;
+            try {
+                this.specFile = yield (0, SpecificationFile_1.load)(filePath);
+                // eslint-disable-next-line sonarjs/no-duplicate-string
+                this.metricsMetadata.to_version = flags['target-version'];
+                const ff = (0, SpecificationFile_1.retrieveFileFormat)(this.specFile.text());
+                const isSpecFileJson = ff === 'json';
+                const isSpecFileYaml = ff === 'yaml';
+                if (!isSpecFileJson && !isSpecFileYaml) {
+                    throw new specification_file_1.SpecificationWrongFileFormat(filePath);
+                }
+                convertedFile = this.handleConversion(isSpecFileJson, isSpecFileYaml, outputFileFormat);
+                if (!convertedFile) {
+                    return;
+                }
+                yield this.handleOutput(flags.output, convertedFile, outputFileFormat);
+            }
+            catch (err) {
+                this.error(err);
+            }
+        });
+    }
+    handleConversion(isSpecFileJson, isSpecFileYaml, outputFileFormat) {
+        var _a;
+        const text = (_a = this.specFile) === null || _a === void 0 ? void 0 : _a.text();
+        if (isSpecFileJson && text) {
+            if (outputFileFormat === 'json') {
+                throw new Error(`Your document is already a ${(0, picocolors_1.cyan)('JSON')}`);
+            }
+            return (0, SpecificationFile_1.convertToYaml)(text);
+        }
+        if (isSpecFileYaml && text) {
+            if (outputFileFormat === 'yaml' || outputFileFormat === 'yml') {
+                throw new Error(`Your document is already a ${(0, picocolors_1.cyan)('YAML')}`);
+            }
+            return (0, SpecificationFile_1.convertToJSON)(text);
+        }
+    }
+    handleOutput(outputPath, formattedFile, outputFileFormat) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (outputPath) {
+                outputPath = this.removeExtensionFromOutputPath(outputPath);
+                const finalFileName = `${outputPath}.${outputFileFormat}`;
+                yield fs_1.promises.writeFile(finalFileName, formattedFile, {
+                    encoding: 'utf8',
+                });
+                this.log(`succesfully formatted to ${outputFileFormat} at ${(0, picocolors_1.green)(finalFileName)} ✅`);
+            }
+            else {
+                this.log(formattedFile);
+                this.log(`succesfully logged after formatting to ${outputFileFormat} ✅`);
+            }
+        });
+    }
+    removeExtensionFromOutputPath(filename) {
+        var _a;
+        // Removes the extension from a filename if it is .json, .yaml, or .yml
+        // this is so that we can remove the provided extension name in the -o flag and
+        // apply our own extension name according to the content of the file
+        const validExtensions = ['json', 'yaml', 'yml'];
+        const parts = filename.split('.');
+        if (parts.length > 1) {
+            const extension = (_a = parts.pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+            if (extension && validExtensions.includes(extension)) {
+                return parts.join('.');
+            }
+        }
+        return filename;
+    }
+}
+exports.default = Convert;
+Convert.metricsMetadata = {};
+Convert.description = 'Convert asyncapi documents from any format to yaml, yml or JSON';
+Convert.flags = (0, format_flags_1.convertFormatFlags)();
+Convert.args = {
+    'spec-file': core_1.Args.string({
+        description: 'spec path, url, or context-name',
+        required: false,
+    }),
+};

package/lib/commands/validate.d.ts

@@ -5,7 +5,8 @@ export default class Validate extends Command {
         score: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'log-diagnostics': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'diagnostics-format': import("@oclif/core/lib/interfaces").OptionFlag<import("@stoplight/spectral-cli/dist/services/config").OutputFormat, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"error" | "warn" | "info" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+        'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"info" | "error" | "warn" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
         watch: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };

package/lib/core/errors/specification-file.d.ts

@@ -4,6 +4,9 @@ declare class SpecificationFileError extends Error {
 export declare class SpecificationFileNotFound extends SpecificationFileError {
     constructor(filePath?: string);
 }
+export declare class SpecificationWrongFileFormat extends SpecificationFileError {
+    constructor(filePath?: string);
+}
 export declare class SpecificationURLNotFound extends SpecificationFileError {
     constructor(URL: string);
 }

package/lib/core/errors/specification-file.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorLoadingSpec = exports.SpecificationURLNotFound = exports.SpecificationFileNotFound = void 0;
+exports.ErrorLoadingSpec = exports.SpecificationURLNotFound = exports.SpecificationWrongFileFormat = exports.SpecificationFileNotFound = void 0;
 const context_error_1 = require("./context-error");
 class SpecificationFileError extends Error {
     constructor() {
@@ -20,6 +20,13 @@ class SpecificationFileNotFound extends SpecificationFileError {
     }
 }
 exports.SpecificationFileNotFound = SpecificationFileNotFound;
+class SpecificationWrongFileFormat extends SpecificationFileError {
+    constructor(filePath) {
+        super();
+        this.message = `File ${filePath} is not of correct format.`;
+    }
+}
+exports.SpecificationWrongFileFormat = SpecificationWrongFileFormat;
 class SpecificationURLNotFound extends SpecificationFileError {
     constructor(URL) {
         super();

package/lib/core/flags/diff.flags.d.ts

@@ -1,7 +1,8 @@
 export declare const diffFlags: () => {
     'log-diagnostics': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'diagnostics-format': import("@oclif/core/lib/interfaces").OptionFlag<import("@stoplight/spectral-cli/dist/services/config").OutputFormat, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"error" | "warn" | "info" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+    'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"info" | "error" | "warn" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+    output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
     format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     type: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;

package/lib/core/flags/format.flags.d.ts

@@ -0,0 +1,6 @@
+export type fileFormat = 'yaml' | 'yml' | 'json';
+export declare const convertFormatFlags: () => {
+    help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+};

package/lib/core/flags/format.flags.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertFormatFlags = void 0;
+const core_1 = require("@oclif/core");
+const availFileFormats = ['yaml', 'yml', 'json'];
+const convertFormatFlags = () => {
+    return {
+        help: core_1.Flags.help({ char: 'h' }),
+        format: core_1.Flags.string({
+            char: 'f',
+            description: 'Specify the format to convert to',
+            options: availFileFormats,
+            required: true,
+            default: 'json',
+        }),
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'path to the file where the result is saved',
+        }),
+    };
+};
+exports.convertFormatFlags = convertFormatFlags;

package/lib/core/flags/validate.flags.d.ts

@@ -2,7 +2,8 @@ export declare const validateFlags: () => {
     score: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'log-diagnostics': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'diagnostics-format': import("@oclif/core/lib/interfaces").OptionFlag<import("@stoplight/spectral-cli/dist/services/config").OutputFormat, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"error" | "warn" | "info" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+    'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"info" | "error" | "warn" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+    output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
     watch: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
 };

package/lib/core/models/SpecificationFile.d.ts

@@ -1,3 +1,4 @@
+import { fileFormat } from 'core/flags/format.flags';
 export declare class Specification {
     private readonly spec;
     private readonly filePath?;
@@ -33,4 +34,7 @@ export declare function load(filePathOrContextName?: string, loadType?: LoadType
 export declare function nameType(name: string): Promise<string>;
 export declare function isURL(urlpath: string): Promise<boolean>;
 export declare function fileExists(name: string): Promise<boolean>;
+export declare function retrieveFileFormat(content: string): fileFormat | undefined;
+export declare function convertToYaml(spec: string): string | undefined;
+export declare function convertToJSON(spec: string): string | undefined;
 export {};

package/lib/core/models/SpecificationFile.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fileExists = exports.isURL = exports.nameType = exports.load = exports.Specification = void 0;
+exports.convertToJSON = exports.convertToYaml = exports.retrieveFileFormat = exports.fileExists = exports.isURL = exports.nameType = exports.load = exports.Specification = void 0;
 const tslib_1 = require("tslib");
 const fs_1 = require("fs");
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -226,3 +226,42 @@ function detectSpecFile() {
         return existingFileNames.find(filename => filename !== undefined);
     });
 }
+function retrieveFileFormat(content) {
+    try {
+        if (content.trimStart()[0] === '{') {
+            JSON.parse(content);
+            return 'json';
+        }
+        // below yaml.load is not a definitive way to determine if a file is yaml or not.
+        // it is able to load .txt text files also.
+        js_yaml_1.default.load(content);
+        return 'yaml';
+    }
+    catch (err) {
+        return undefined;
+    }
+}
+exports.retrieveFileFormat = retrieveFileFormat;
+function convertToYaml(spec) {
+    try {
+        // JS object -> YAML string
+        const jsonContent = js_yaml_1.default.load(spec);
+        return js_yaml_1.default.dump(jsonContent);
+    }
+    catch (err) {
+        console.error(err);
+    }
+}
+exports.convertToYaml = convertToYaml;
+function convertToJSON(spec) {
+    try {
+        // JSON or YAML String -> JS object
+        const jsonContent = js_yaml_1.default.load(spec);
+        // JS Object -> pretty JSON string
+        return JSON.stringify(jsonContent, null, 2);
+    }
+    catch (err) {
+        console.error(err);
+    }
+}
+exports.convertToJSON = convertToJSON;

package/lib/core/parser.d.ts

@@ -15,12 +15,14 @@ export declare enum ValidationStatus {
 export declare function validationFlags({ logDiagnostics }?: ValidationFlagsOptions): {
     'log-diagnostics': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'diagnostics-format': import("@oclif/core/lib/interfaces").OptionFlag<OutputFormat, import("@oclif/core/lib/interfaces").CustomOptions>;
-    'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"error" | "warn" | "info" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+    'fail-severity': import("@oclif/core/lib/interfaces").OptionFlag<"info" | "error" | "warn" | "hint", import("@oclif/core/lib/interfaces").CustomOptions>;
+    output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
 };
 export interface ValidateOptions {
     'log-diagnostics'?: boolean;
     'diagnostics-format'?: `${OutputFormat}`;
     'fail-severity'?: SeverityKind;
+    'output'?: string;
 }
 export declare function validate(command: Command, specFile: Specification, options?: ValidateOptions): Promise<"valid" | "invalid">;
 export declare function parse(command: Command, specFile: Specification, options?: ValidateOptions): Promise<{

package/lib/core/parser.js

@@ -13,6 +13,19 @@ const spectral_core_1 = require("@stoplight/spectral-core");
 const config_1 = require("@stoplight/spectral-cli/dist/services/config");
 const spectral_formatters_1 = require("@stoplight/spectral-formatters");
 const chalk_1 = require("chalk");
+const fs_1 = require("fs");
+const path_1 = tslib_1.__importDefault(require("path"));
+const { writeFile } = fs_1.promises;
+const formatExtensions = {
+    stylish: '.txt',
+    json: '.json',
+    junit: '.xml',
+    html: '.html',
+    text: '.txt',
+    teamcity: '.txt',
+    pretty: '.txt',
+};
+const validFormats = ['stylish', 'json', 'junit', 'html', 'text', 'teamcity', 'pretty'];
 const parser = new cjs_1.Parser({
     __unstable: {
         resolver: {
@@ -46,6 +59,10 @@ function validationFlags({ logDiagnostics = true } = {}) {
             options: ['error', 'warn', 'info', 'hint'],
             default: 'error',
         })(),
+        output: core_1.Flags.string({
+            description: 'The output file name. Omitting this flag the result will be printed in the console.',
+            char: 'o'
+        })
     };
 }
 exports.validationFlags = validationFlags;
@@ -70,23 +87,33 @@ function logDiagnostics(diagnostics, command, specFile, options = {}) {
     const failSeverity = (_a = options['fail-severity']) !== null && _a !== void 0 ? _a : 'error';
     const diagnosticsFormat = (_b = options['diagnostics-format']) !== null && _b !== void 0 ? _b : 'stylish';
     const sourceString = specFile.toSourceString();
-    if (diagnostics.length) {
-        if (hasFailSeverity(diagnostics, failSeverity)) {
-            if (logDiagnostics) {
-                command.logToStderr(`\n${sourceString} and/or referenced documents have governance issues.`);
-                command.logToStderr(formatOutput(diagnostics, diagnosticsFormat, failSeverity));
-            }
-            return ValidationStatus.INVALID;
-        }
-        if (logDiagnostics) {
-            command.log(`\n${sourceString} is valid but has (itself and/or referenced documents) governance issues.`);
-            command.log(formatOutput(diagnostics, diagnosticsFormat, failSeverity));
-        }
+    const hasIssues = diagnostics.length > 0;
+    const isFailSeverity = hasIssues && hasFailSeverity(diagnostics, failSeverity);
+    if (logDiagnostics) {
+        logGovernanceMessage(command, sourceString, hasIssues, isFailSeverity);
+        outputDiagnostics(command, diagnostics, diagnosticsFormat, failSeverity, options);
     }
-    else if (logDiagnostics) {
+    return isFailSeverity ? ValidationStatus.INVALID : ValidationStatus.VALID;
+}
+function logGovernanceMessage(command, sourceString, hasIssues, isFailSeverity) {
+    if (!hasIssues) {
         command.log(`\n${sourceString} is valid! ${sourceString} and referenced documents don't have governance issues.`);
     }
-    return ValidationStatus.VALID;
+    else if (isFailSeverity) {
+        command.logToStderr(`\n${sourceString} and/or referenced documents have governance issues.`);
+    }
+    else {
+        command.log(`\n${sourceString} is valid but has (itself and/or referenced documents) governance issues.`);
+    }
+}
+function outputDiagnostics(command, diagnostics, diagnosticsFormat, failSeverity, options) {
+    const diagnosticsOutput = formatOutput(diagnostics, diagnosticsFormat, failSeverity);
+    if (options.output) {
+        writeValidationDiagnostic(options.output, command, diagnosticsFormat, diagnosticsOutput);
+    }
+    else {
+        command.log(diagnosticsOutput);
+    }
 }
 function formatOutput(diagnostics, format, failSeverity) {
     const diagnosticSeverity = (0, spectral_core_1.getDiagnosticSeverity)(failSeverity);
@@ -128,3 +155,22 @@ function hasFailSeverity(diagnostics, failSeverity) {
     const diagnosticSeverity = (0, spectral_core_1.getDiagnosticSeverity)(failSeverity);
     return diagnostics.some(diagnostic => diagnostic.severity <= diagnosticSeverity);
 }
+function writeValidationDiagnostic(outputPath, command, format, formatOutput) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (!validFormats.includes(format)) {
+            command.logToStderr(`Invalid diagnostics format: "${format}"`);
+            return;
+        }
+        const expectedExtension = formatExtensions[format];
+        const actualExtension = path_1.default.extname(outputPath);
+        // Validate file extension against diagnostics format
+        if (expectedExtension && (actualExtension !== expectedExtension)) {
+            command.logToStderr(`Invalid file extension for format "${format}". Expected extension: "${expectedExtension}"`);
+        }
+        else {
+            yield writeFile(path_1.default.resolve(process.cwd(), outputPath), formatOutput, {
+                encoding: 'utf-8',
+            }).catch(err => console.log(err));
+        }
+    });
+}

package/oclif.manifest.json

@@ -267,6 +267,14 @@
             "hint"
           ],
           "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "The output file name. Omitting this flag the result will be printed in the console.",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -283,6 +291,63 @@
         "diff.js"
       ]
     },
+    "format": {
+      "aliases": [],
+      "args": {
+        "spec-file": {
+          "description": "spec path, url, or context-name",
+          "name": "spec-file",
+          "required": false
+        }
+      },
+      "description": "Convert asyncapi documents from any format to yaml, yml or JSON",
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "format": {
+          "char": "f",
+          "description": "Specify the format to convert to",
+          "name": "format",
+          "required": true,
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "yaml",
+            "yml",
+            "json"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "path to the file where the result is saved",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "format",
+      "pluginAlias": "@asyncapi/cli",
+      "pluginName": "@asyncapi/cli",
+      "pluginType": "core",
+      "strict": true,
+      "metricsMetadata": {},
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "format.js"
+      ]
+    },
     "optimize": {
       "aliases": [],
       "args": {
@@ -437,6 +502,14 @@
           ],
           "type": "option"
         },
+        "output": {
+          "char": "o",
+          "description": "The output file name. Omitting this flag the result will be printed in the console.",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "score": {
           "description": "Compute the score of the AsyncAPI document. Scoring is based on whether the document has description, license, server and/or channels.",
           "name": "score",
@@ -757,9 +830,8 @@
         },
         "output": {
           "char": "o",
-          "description": "The output directory where the models should be written to. Omitting this flag will write the models to `stdout`.",
+          "description": "The output file name. Omitting this flag the result will be printed in the console.",
           "name": "output",
-          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1622,5 +1694,5 @@
       ]
     }
   },
-  "version": "2.8.1"
+  "version": "2.10.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@asyncapi/cli",
   "description": "All in one CLI for all AsyncAPI tools",
-  "version": "2.8.1",
+  "version": "2.10.0",
   "author": "@asyncapi",
   "bin": {
     "asyncapi": "./bin/run_bin"