@asyncapi/cli 2.14.1 → 2.16.0

package/lib/commands/convert.d.ts

@@ -4,6 +4,8 @@ export default class Convert extends Command {
     static metricsMetadata: any;
     static description: string;
     static flags: {
+        proxyHost: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        proxyPort: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
         output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -12,6 +14,8 @@ export default class Convert extends Command {
     };
     static args: {
         'spec-file': import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        proxyHost: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        proxyPort: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     run(): Promise<void>;
     private handleConversion;

package/lib/commands/convert.js

@@ -10,6 +10,7 @@ const SpecificationFile_1 = require("../core/models/SpecificationFile");
 const specification_file_1 = require("../core/errors/specification-file");
 const converter_1 = require("@asyncapi/converter");
 const picocolors_1 = require("picocolors");
+const proxy_flags_1 = require("../core/flags/proxy.flags");
 // @ts-ignore
 const specs_1 = tslib_1.__importDefault(require("@asyncapi/specs"));
 const convert_flags_1 = require("../core/flags/convert.flags");
@@ -18,7 +19,13 @@ 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'];
+            let filePath = args['spec-file'];
+            const proxyHost = flags['proxyHost'];
+            const proxyPort = flags['proxyPort'];
+            if (proxyHost && proxyPort) {
+                const proxyUrl = `http://${proxyHost}:${proxyPort}`;
+                filePath = `${filePath}+${proxyUrl}`; // Update filePath with proxyUrl
+            }
             let convertedFile;
             let convertedFileFormatted;
             try {
@@ -119,7 +126,9 @@ class Convert extends base_1.default {
 exports.default = Convert;
 Convert.metricsMetadata = {};
 Convert.description = 'Convert asyncapi documents older to newer versions or OpenAPI/postman-collection documents to AsyncAPI';
-Convert.flags = (0, convert_flags_1.convertFlags)(latestVersion);
+Convert.flags = Object.assign(Object.assign({}, (0, convert_flags_1.convertFlags)(latestVersion)), (0, proxy_flags_1.proxyFlags)());
 Convert.args = {
     'spec-file': core_1.Args.string({ description: 'spec path, url, or context-name', required: false }),
+    proxyHost: core_1.Args.string({ description: 'Name of the Proxy Host', required: false }),
+    proxyPort: core_1.Args.string({ description: 'Name of the Port of the ProxyHost', required: false }),
 };

package/lib/commands/generate/fromTemplate.js

@@ -116,7 +116,7 @@ class Template extends base_1.default {
                 }
             }
             if (flags['use-new-generator']) {
-                yield this.generateUsingNewGenerator(asyncapi, template, output, options, genOption, interactive);
+                yield this.generateUsingNewGenerator(asyncapi, template, output, options, genOption);
             }
             else {
                 yield this.generate(asyncapi, template, output, options, genOption, interactive);
@@ -287,7 +287,7 @@ class Template extends base_1.default {
             s.stop(`${(0, picocolors_1.yellow)('Check out your shiny new generated files at ') + (0, picocolors_1.magenta)(output) + (0, picocolors_1.yellow)('.')}\n`);
         });
     }
-    generateUsingNewGenerator(asyncapi, template, output, options, genOption, interactive = true) {
+    generateUsingNewGenerator(asyncapi, template, output, options, genOption) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             let specification;
             try {
@@ -300,16 +300,15 @@ class Template extends base_1.default {
                 }), { exit: 1 });
             }
             const generator = new generator_v2_1.default(template, output || path_1.default.resolve(os_1.default.tmpdir(), 'asyncapi-generator'), options);
-            const s = interactive ? (0, prompts_1.spinner)() : { start: () => null, stop: (string) => console.log(string) };
-            s.start('Generation in progress. Keep calm and wait a bit');
+            this.log('Generation in progress. Keep calm and wait a bit');
             try {
                 yield generator.generateFromString(specification.text(), Object.assign(Object.assign({}, genOption), { path: asyncapi }));
             }
             catch (err) {
-                s.stop('Generation failed');
+                this.log('Generation failed');
                 throw new generator_error_1.GeneratorError(err);
             }
-            s.stop(`${(0, picocolors_1.yellow)('Check out your shiny new generated files at ') + (0, picocolors_1.magenta)(output) + (0, picocolors_1.yellow)('.')}\n`);
+            this.log(`${(0, picocolors_1.yellow)('Check out your shiny new generated files at ') + (0, picocolors_1.magenta)(output) + (0, picocolors_1.yellow)('.')}\n`);
         });
     }
     runWatchMode(asyncapi, template, output, watchHandler) {

package/lib/commands/generate/models.js

@@ -45,19 +45,30 @@ class Models extends base_1.default {
             };
             const s = (0, prompts_1.spinner)();
             s.start('Generating models...');
-            const generatedModels = yield (0, modelina_cli_1.generateModels)(Object.assign(Object.assign({}, flags), { output }), document, logger, language);
-            if (output !== 'stdout') {
-                const generatedModelStrings = generatedModels.map((model) => { return model.modelName; });
-                s.stop((0, picocolors_1.green)(`Successfully generated the following models: ${generatedModelStrings.join(', ')}`));
-                return;
+            try {
+                const generatedModels = yield (0, modelina_cli_1.generateModels)(Object.assign(Object.assign({}, flags), { output }), document, logger, language);
+                if (output !== 'stdout') {
+                    const generatedModelStrings = generatedModels.map((model) => { return model.modelName; });
+                    s.stop((0, picocolors_1.green)(`Successfully generated the following models: ${generatedModelStrings.join(', ')}`));
+                    return;
+                }
+                const generatedModelStrings = generatedModels.map((model) => {
+                    return `
+  ## Model name: ${model.modelName}
+  ${model.result}
+        `;
+                });
+                s.stop((0, picocolors_1.green)(`Successfully generated the following models: ${generatedModelStrings.join('\n')}`));
+            }
+            catch (error) {
+                s.stop((0, picocolors_1.green)('Failed to generate models'));
+                if (error instanceof Error) {
+                    this.error(error.message);
+                }
+                else {
+                    this.error('An unknown error occurred during model generation.');
+                }
             }
-            const generatedModelStrings = generatedModels.map((model) => {
-                return `
-## Model name: ${model.modelName}
-${model.result}
-      `;
-            });
-            s.stop((0, picocolors_1.green)(`Successfully generated the following models: ${generatedModelStrings.join('\n')}`));
         });
     }
     parseArgs(args, output) {

package/lib/commands/new/file.js

@@ -155,5 +155,5 @@ NewFile.description = 'Creates a new asyncapi file';
 NewFile.flags = (0, file_flags_1.fileFlags)(getExamplesFlagDescription());
 NewFile.examples = [
     'asyncapi new\t - start creation of a file in interactive mode',
-    'asyncapi new --file-name=my-asyncapi.yml --example=default-example.yml --no-tty\t - create a new file with a specific name, using one of the examples and without interactive mode'
+    'asyncapi new --file-name=my-asyncapi.yaml --example=default-example.yaml --no-tty\t - create a new file with a specific name, using one of the examples and without interactive mode'
 ];

package/lib/commands/optimize.d.ts

@@ -22,6 +22,8 @@ export default class Optimize extends Command {
     outputMethod?: Outputs;
     static examples: string[];
     static flags: {
+        proxyHost: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        proxyPort: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
         optimization: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
         ignore: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -30,6 +32,8 @@ export default class Optimize extends Command {
     };
     static args: {
         'spec-file': import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        proxyHost: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        proxyPort: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     parser: Parser;
     run(): Promise<void>;

package/lib/commands/optimize.js

@@ -12,6 +12,7 @@ const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const fs_1 = require("fs");
 const parser_1 = require("@asyncapi/parser");
 const optimize_flags_1 = require("../core/flags/optimize.flags");
+const proxy_flags_1 = require("../core/flags/proxy.flags");
 const { writeFile } = fs_1.promises;
 var Optimizations;
 (function (Optimizations) {
@@ -40,15 +41,26 @@ class Optimize extends base_1.default {
         var _a, _b, _c, _d;
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             const { args, flags } = yield this.parse(Optimize); //NOSONAR
-            const filePath = args['spec-file'];
+            let filePath = args['spec-file'];
+            const proxyHost = flags['proxyHost'];
+            const proxyPort = flags['proxyPort'];
+            if (proxyHost && proxyPort) {
+                const proxyUrl = `http://${proxyHost}:${proxyPort}`;
+                filePath = `${filePath}+${proxyUrl}`; // Update filePath with proxyUrl
+            }
             try {
                 this.specFile = yield (0, SpecificationFile_1.load)(filePath);
             }
             catch (err) {
-                this.error(new validation_error_1.ValidationError({
-                    type: 'invalid-file',
-                    filepath: filePath,
-                }));
+                if (err.message.includes('Failed to download')) {
+                    throw new Error('Proxy Connection Error: Unable to establish a connection to the proxy check hostName or PortNumber.');
+                }
+                else {
+                    this.error(new validation_error_1.ValidationError({
+                        type: 'invalid-file',
+                        filepath: filePath,
+                    }));
+                }
             }
             let optimizer;
             let report;
@@ -221,7 +233,9 @@ Optimize.examples = [
     'asyncapi optimize ./asyncapi.yaml --optimization=remove-components --output=terminal --no-tty',
     'asyncapi optimize ./asyncapi.yaml --ignore=schema'
 ];
-Optimize.flags = (0, optimize_flags_1.optimizeFlags)();
+Optimize.flags = Object.assign(Object.assign({}, (0, optimize_flags_1.optimizeFlags)()), (0, proxy_flags_1.proxyFlags)());
 Optimize.args = {
     'spec-file': core_1.Args.string({ description: 'spec path, url, or context-name', required: false }),
+    proxyHost: core_1.Args.string({ description: 'Name of the Proxy Host', required: false }),
+    proxyPort: core_1.Args.string({ description: 'Name of the Port of the ProxyHost', required: false }),
 };

package/lib/commands/pretty.d.ts

@@ -1,6 +1,6 @@
 import Command from '../core/base';
 export default class Pretty extends Command {
-    static readonly description = "Format AsyncAPI specification file";
+    static readonly description = "Beautify the AsyncAPI spec file (indentation, styling) in place or output the formatted spec to a new file.";
     static readonly examples: string[];
     static readonly flags: {
         output: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/lib/commands/pretty.js

@@ -56,7 +56,7 @@ class Pretty extends base_1.default {
     }
 }
 exports.default = Pretty;
-Pretty.description = 'Format AsyncAPI specification file';
+Pretty.description = 'Beautify the AsyncAPI spec file (indentation, styling) in place or output the formatted spec to a new file.';
 Pretty.examples = [
     'asyncapi pretty ./asyncapi.yaml',
     'asyncapi pretty ./asyncapi.yaml --output formatted-asyncapi.yaml',

package/lib/commands/start/studio.d.ts

@@ -6,5 +6,8 @@ export default class StartStudio extends Command {
         file: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         port: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
+    static readonly args: {
+        'spec-file': import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     run(): Promise<void>;
 }

package/lib/commands/start/studio.js

@@ -5,13 +5,35 @@ const base_1 = tslib_1.__importDefault(require("../../core/base"));
 const Studio_1 = require("../../core/models/Studio");
 const SpecificationFile_1 = require("../../core/models/SpecificationFile");
 const studio_flags_1 = require("../../core/flags/start/studio.flags");
+const core_1 = require("@oclif/core");
 class StartStudio extends base_1.default {
     run() {
+        var _a;
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            const { flags } = yield this.parse(StartStudio);
-            const filePath = flags.file || (yield (0, SpecificationFile_1.load)()).getFilePath();
+            const { args, flags } = yield this.parse(StartStudio);
+            if (flags.file) {
+                this.warn('The file flag has been removed and is being replaced by the argument spec-file. Please pass the filename directly like `asyncapi start studio asyncapi.yml`');
+            }
+            let filePath = (_a = args['spec-file']) !== null && _a !== void 0 ? _a : flags.file;
             const port = flags.port;
-            this.specFile = yield (0, SpecificationFile_1.load)(filePath);
+            if (!filePath) {
+                try {
+                    filePath = ((yield (0, SpecificationFile_1.load)()).getFilePath());
+                    this.log(`Loaded specification from: ${filePath}`);
+                }
+                catch (error) {
+                    filePath = '';
+                    this.error('No file specified.');
+                }
+            }
+            try {
+                this.specFile = yield (0, SpecificationFile_1.load)(filePath);
+            }
+            catch (error) {
+                if (filePath) {
+                    this.error(error);
+                }
+            }
             this.metricsMetadata.port = port;
             (0, Studio_1.start)(filePath, port);
         });
@@ -20,3 +42,6 @@ class StartStudio extends base_1.default {
 exports.default = StartStudio;
 StartStudio.description = 'starts a new local instance of Studio';
 StartStudio.flags = (0, studio_flags_1.studioFlags)();
+StartStudio.args = {
+    'spec-file': core_1.Args.string({ description: 'spec path, url, or context-name', required: false }),
+};

package/lib/commands/validate.d.ts

@@ -2,6 +2,8 @@ import Command from '../core/base';
 export default class Validate extends Command {
     static description: string;
     static flags: {
+        proxyHost: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        proxyPort: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         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>;
@@ -12,6 +14,8 @@ export default class Validate extends Command {
     };
     static args: {
         'spec-file': import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        proxyHost: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        proxyPort: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     run(): Promise<void>;
 }

package/lib/commands/validate.js

@@ -7,19 +7,25 @@ const parser_1 = require("../core/parser");
 const SpecificationFile_1 = require("../core/models/SpecificationFile");
 const globals_1 = require("../core/globals");
 const validate_flags_1 = require("../core/flags/validate.flags");
+const proxy_flags_1 = require("../core/flags/proxy.flags");
 const scoreCalculator_1 = require("../core/utils/scoreCalculator");
 class Validate extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             const { args, flags } = yield this.parse(Validate); //NOSONAR
-            const filePath = args['spec-file'];
+            let filePath = args['spec-file'];
+            const proxyHost = flags['proxyHost'];
+            const proxyPort = flags['proxyPort'];
+            if (proxyHost && proxyPort) {
+                const proxyUrl = `http://${proxyHost}:${proxyPort}`;
+                filePath = `${filePath}+${proxyUrl}`; // Update filePath with proxyUrl
+            }
+            this.specFile = yield (0, SpecificationFile_1.load)(filePath);
             const watchMode = flags.watch;
             if (flags['score']) {
-                this.specFile = yield (0, SpecificationFile_1.load)(filePath);
                 const { document } = yield (0, parser_1.parse)(this, this.specFile);
                 this.log(`The score of the asyncapi document is ${yield (0, scoreCalculator_1.calculateScore)(document)}`);
             }
-            this.specFile = yield (0, SpecificationFile_1.load)(filePath);
             if (watchMode) {
                 (0, globals_1.specWatcher)({ spec: this.specFile, handler: this, handlerName: 'validate' });
             }
@@ -33,7 +39,9 @@ class Validate extends base_1.default {
 }
 exports.default = Validate;
 Validate.description = 'validate asyncapi file';
-Validate.flags = (0, validate_flags_1.validateFlags)();
+Validate.flags = Object.assign(Object.assign({}, (0, validate_flags_1.validateFlags)()), (0, proxy_flags_1.proxyFlags)());
 Validate.args = {
     'spec-file': core_1.Args.string({ description: 'spec path, url, or context-name', required: false }),
+    proxyHost: core_1.Args.string({ description: 'Name of the Proxy Host', required: false }),
+    proxyPort: core_1.Args.string({ description: 'Name of the Port of the ProxyHost', required: false }),
 };

package/lib/core/base.js

@@ -43,6 +43,10 @@ class default_1 extends core_1.Command {
                 return yield _super.catch.call(this, err);
             }
             catch (e) {
+                if (e.message.includes('EEXIT: 0')) {
+                    process.exitCode = 0;
+                    return;
+                }
                 if (e instanceof Error) {
                     this.logToStderr(`${e.name}: ${e.message}`);
                     process.exitCode = 1;

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

@@ -0,0 +1,4 @@
+export declare const proxyFlags: () => {
+    proxyHost: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    proxyPort: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+};

package/lib/core/flags/proxy.flags.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proxyFlags = void 0;
+const core_1 = require("@oclif/core");
+const proxyFlags = () => {
+    return {
+        proxyHost: core_1.Flags.string({
+            description: 'Name of the ProxyHost',
+            required: false
+        }),
+        proxyPort: core_1.Flags.string({
+            description: 'Port number number for the proxyHost.',
+            required: false
+        })
+    };
+};
+exports.proxyFlags = proxyFlags;

package/lib/core/flags/start/studio.flags.js

@@ -5,7 +5,7 @@ const core_1 = require("@oclif/core");
 const studioFlags = () => {
     return {
         help: core_1.Flags.help({ char: 'h' }),
-        file: core_1.Flags.string({ char: 'f', description: 'path to the AsyncAPI file to link with Studio' }),
+        file: core_1.Flags.string({ char: 'f', description: 'path to the AsyncAPI file to link with Studio', deprecated: true }),
         port: core_1.Flags.integer({ char: 'p', description: 'port in which to start Studio' }),
     };
 };

package/lib/core/models/SpecificationFile.js

@@ -10,6 +10,7 @@ const js_yaml_1 = tslib_1.__importDefault(require("js-yaml"));
 const Context_1 = require("./Context");
 const specification_file_1 = require("../errors/specification-file");
 const context_error_1 = require("../errors/context-error");
+const https_proxy_agent_1 = require("https-proxy-agent");
 const { readFile, lstat } = fs_1.promises;
 const allowedFileNames = [
     'asyncapi.json',
@@ -80,16 +81,41 @@ class Specification {
     static fromURL(URLpath) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             let response;
+            const delimiter = '+';
+            let targetUrl = URLpath;
+            let proxyUrl = '';
+            // Check if URLpath contains a proxy URL
+            if (URLpath.includes(delimiter)) {
+                [targetUrl, proxyUrl] = URLpath.split(delimiter);
+            }
             try {
-                response = yield (0, node_fetch_1.default)(URLpath, { method: 'GET' });
-                if (!response.ok) {
-                    throw new specification_file_1.ErrorLoadingSpec('url', URLpath);
+                // Validate the target URL
+                new url_1.URL(targetUrl);
+                const fetchOptions = { method: 'GET' };
+                // If proxy URL is provided, create a proxy agent
+                if (proxyUrl) {
+                    try {
+                        new url_1.URL(proxyUrl);
+                        const proxyAgent = new https_proxy_agent_1.HttpsProxyAgent(proxyUrl);
+                        fetchOptions.agent = proxyAgent;
+                        response = yield (0, node_fetch_1.default)(targetUrl, fetchOptions);
+                    }
+                    catch (err) {
+                        throw new Error('Proxy Connection Error: Unable to establish a connection to the proxy check hostName or PortNumber');
+                    }
+                }
+                else {
+                    response = yield (0, node_fetch_1.default)(targetUrl);
+                    if (!response.ok) {
+                        throw new specification_file_1.ErrorLoadingSpec('url', targetUrl);
+                    }
                 }
             }
             catch (error) {
-                throw new specification_file_1.ErrorLoadingSpec('url', URLpath);
+                console.log(error);
+                throw new specification_file_1.ErrorLoadingSpec('url', targetUrl);
             }
-            return new Specification(yield (response === null || response === void 0 ? void 0 : response.text()), { fileURL: URLpath });
+            return new Specification(yield (response === null || response === void 0 ? void 0 : response.text()), { fileURL: targetUrl });
         });
     }
 }

package/lib/core/models/Studio.js

@@ -20,30 +20,32 @@ function isValidFilePath(filePath) {
     return (0, fs_1.existsSync)(filePath);
 }
 function start(filePath, port = exports.DEFAULT_PORT) {
-    if (!isValidFilePath(filePath)) {
+    if (filePath && !isValidFilePath(filePath)) {
         throw new specification_file_1.SpecificationFileNotFound(filePath);
     }
-    chokidar_1.default.watch(filePath).on('all', (event, path) => {
-        switch (event) {
-            case 'add':
-            case 'change':
-                getFileContent(path).then((code) => {
+    if (filePath) {
+        chokidar_1.default.watch(filePath).on('all', (event, path) => {
+            switch (event) {
+                case 'add':
+                case 'change':
+                    getFileContent(path).then((code) => {
+                        messageQueue.push(JSON.stringify({
+                            type: 'file:changed',
+                            code,
+                        }));
+                        sendQueuedMessages();
+                    });
+                    break;
+                case 'unlink':
                     messageQueue.push(JSON.stringify({
-                        type: 'file:changed',
-                        code,
+                        type: 'file:deleted',
+                        filePath,
                     }));
                     sendQueuedMessages();
-                });
-                break;
-            case 'unlink':
-                messageQueue.push(JSON.stringify({
-                    type: 'file:deleted',
-                    filePath,
-                }));
-                sendQueuedMessages();
-                break;
-        }
-    });
+                    break;
+            }
+        });
+    }
     const server = (0, http_1.createServer)((request, response) => {
         //not all CLI users use npm. Some package managers put dependencies in different weird places
         //this is why we need to first figure out where exactly is the index.html located
@@ -67,17 +69,26 @@ function start(filePath, port = exports.DEFAULT_PORT) {
     const wsServer = new ws_1.WebSocketServer({ noServer: true });
     wsServer.on('connection', (socket) => {
         sockets.push(socket);
-        getFileContent(filePath).then((code) => {
+        if (filePath) {
+            getFileContent(filePath).then((code) => {
+                messageQueue.push(JSON.stringify({
+                    type: 'file:loaded',
+                    code,
+                }));
+                sendQueuedMessages();
+            });
+        }
+        else {
             messageQueue.push(JSON.stringify({
                 type: 'file:loaded',
-                code,
+                code: '',
             }));
             sendQueuedMessages();
-        });
+        }
         socket.on('message', (event) => {
             try {
                 const json = JSON.parse(event);
-                if (json.type === 'file:update') {
+                if (filePath && json.type === 'file:update') {
                     saveFileContent(filePath, json.code);
                 }
                 else {
@@ -97,7 +108,12 @@ function start(filePath, port = exports.DEFAULT_PORT) {
         const url = `http://localhost:${port}?liveServer=${port}&studio-version=${package_json_1.version}`;
         console.log(`Studio is now running at ${url}.`);
         console.log(`You can open this URL in your web browser, and if needed, press ${(0, picocolors_1.gray)('Ctrl + C')} to stop the process.`);
-        console.log(`Watching changes on file ${filePath}`);
+        if (filePath) {
+            console.log(`Watching changes on file ${filePath}`);
+        }
+        else {
+            console.warn('Warning: No file was provided, and we couldn\'t find a default file (like "asyncapi.yaml" or "asyncapi.json") in the current folder. Starting Studio with a blank workspace.');
+        }
         (0, open_1.default)(url);
     });
 }

package/oclif.manifest.json

@@ -73,6 +73,16 @@
           "description": "spec path, url, or context-name",
           "name": "spec-file",
           "required": false
+        },
+        "proxyHost": {
+          "description": "Name of the Proxy Host",
+          "name": "proxyHost",
+          "required": false
+        },
+        "proxyPort": {
+          "description": "Name of the Port of the ProxyHost",
+          "name": "proxyPort",
+          "required": false
         }
       },
       "description": "Convert asyncapi documents older to newer versions or OpenAPI/postman-collection documents to AsyncAPI",
@@ -128,6 +138,22 @@
             "server"
           ],
           "type": "option"
+        },
+        "proxyHost": {
+          "description": "Name of the ProxyHost",
+          "name": "proxyHost",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "proxyPort": {
+          "description": "Port number number for the proxyHost.",
+          "name": "proxyPort",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -355,6 +381,16 @@
           "description": "spec path, url, or context-name",
           "name": "spec-file",
           "required": false
+        },
+        "proxyHost": {
+          "description": "Name of the Proxy Host",
+          "name": "proxyHost",
+          "required": false
+        },
+        "proxyPort": {
+          "description": "Name of the Port of the ProxyHost",
+          "name": "proxyPort",
+          "required": false
         }
       },
       "description": "optimize asyncapi specification file",
@@ -424,6 +460,22 @@
           "name": "no-tty",
           "allowNo": false,
           "type": "boolean"
+        },
+        "proxyHost": {
+          "description": "Name of the ProxyHost",
+          "name": "proxyHost",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "proxyPort": {
+          "description": "Port number number for the proxyHost.",
+          "name": "proxyPort",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -449,7 +501,7 @@
           "required": true
         }
       },
-      "description": "Format AsyncAPI specification file",
+      "description": "Beautify the AsyncAPI spec file (indentation, styling) in place or output the formatted spec to a new file.",
       "examples": [
         "asyncapi pretty ./asyncapi.yaml",
         "asyncapi pretty ./asyncapi.yaml --output formatted-asyncapi.yaml"
@@ -485,6 +537,16 @@
           "description": "spec path, url, or context-name",
           "name": "spec-file",
           "required": false
+        },
+        "proxyHost": {
+          "description": "Name of the Proxy Host",
+          "name": "proxyHost",
+          "required": false
+        },
+        "proxyPort": {
+          "description": "Name of the Port of the ProxyHost",
+          "name": "proxyPort",
+          "required": false
         }
       },
       "description": "validate asyncapi file",
@@ -554,6 +616,22 @@
           "required": false,
           "allowNo": false,
           "type": "boolean"
+        },
+        "proxyHost": {
+          "description": "Name of the ProxyHost",
+          "name": "proxyHost",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "proxyPort": {
+          "description": "Port number number for the proxyHost.",
+          "name": "proxyPort",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1132,7 +1210,7 @@
       "description": "Creates a new asyncapi file",
       "examples": [
         "asyncapi new\t - start creation of a file in interactive mode",
-        "asyncapi new --file-name=my-asyncapi.yml --example=default-example.yml --no-tty\t - create a new file with a specific name, using one of the examples and without interactive mode"
+        "asyncapi new --file-name=my-asyncapi.yaml --example=default-example.yaml --no-tty\t - create a new file with a specific name, using one of the examples and without interactive mode"
       ],
       "flags": {
         "help": {
@@ -1262,7 +1340,7 @@
       "description": "Creates a new asyncapi file",
       "examples": [
         "asyncapi new\t - start creation of a file in interactive mode",
-        "asyncapi new --file-name=my-asyncapi.yml --example=default-example.yml --no-tty\t - create a new file with a specific name, using one of the examples and without interactive mode"
+        "asyncapi new --file-name=my-asyncapi.yaml --example=default-example.yaml --no-tty\t - create a new file with a specific name, using one of the examples and without interactive mode"
       ],
       "flags": {
         "help": {
@@ -1416,7 +1494,13 @@
     },
     "start:studio": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "spec-file": {
+          "description": "spec path, url, or context-name",
+          "name": "spec-file",
+          "required": false
+        }
+      },
       "description": "starts a new local instance of Studio",
       "flags": {
         "help": {
@@ -1428,6 +1512,7 @@
         },
         "file": {
           "char": "f",
+          "deprecated": true,
           "description": "path to the AsyncAPI file to link with Studio",
           "name": "file",
           "hasDynamicHelp": false,
@@ -1732,5 +1817,5 @@
       ]
     }
   },
-  "version": "2.14.1"
+  "version": "2.16.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@asyncapi/cli",
   "description": "All in one CLI for all AsyncAPI tools",
-  "version": "2.14.1",
+  "version": "2.16.0",
   "author": "@asyncapi",
   "bin": {
     "asyncapi": "./bin/run_bin"
@@ -30,9 +30,9 @@
     "fast-levenshtein": "^3.0.0",
     "fs-extra": "^11.1.0",
     "generator-v2": "npm:@asyncapi/generator@^2.4.1",
+    "https-proxy-agent": "^7.0.6",
     "inquirer": "^8.2.0",
     "js-yaml": "^4.1.0",
-    "lodash.template": "^4.4.0",
     "node-fetch": "^2.0.0",
     "oclif": "^4.2.0",
     "open": "^8.4.0",
@@ -56,7 +56,6 @@
     "@types/fs-extra": "^11.0.1",
     "@types/inquirer": "^8.1.3",
     "@types/js-yaml": "^4.0.5",
-    "@types/lodash.template": "^4.4.4",
     "@types/mocha": "^10.0.2",
     "@types/node": "^10.17.60",
     "@types/node-fetch": "^2.5.12",