@asyncapi/cli 2.15.0 → 2.16.1

package/README.md

@@ -12,6 +12,7 @@ CLI to work with your AsyncAPI files. Currently under development, we are workin
 
 - [Installation](#installation)
 - [Usage](#usage)
+- [Github Action](#github-action)
 - [Contributing](#contributing)
   * [Set up development environment](#set-up-development-environment)
   * [Command Structure and Patterns](#command-structure-and-patterns)
@@ -25,6 +26,9 @@ Learn how to install the AsyncAPI CLI by following the instructions in the [inst
 ## Usage
 The [usage guide](/docs/usage.md) provides information about different ways to use the CLI.
 
+## Github Action
+
+The AsyncAPI CLI can be used as a GitHub Action. You can find more information in the [GitHub Action guide](https://www.asyncapi.com/docs/tools/cli/github-action).
 
 ## Contributing
 

package/lib/commands/config/analytics.js

@@ -6,6 +6,7 @@ const base_1 = tslib_1.__importDefault(require("../../core/base"));
 const fs_1 = require("fs");
 const os_1 = require("os");
 const analytics_flags_1 = require("../../core/flags/config/analytics.flags");
+const picocolors_1 = require("picocolors");
 const { readFile, writeFile } = fs_1.promises;
 class Analytics extends base_1.default {
     run() {
@@ -25,7 +26,7 @@ class Analytics extends base_1.default {
                     this.metricsMetadata.analytics_enabled = flags.enable;
                 }
                 else if (!flags.status) {
-                    this.log('\nPlease append the "--disable" flag to the command in case you prefer to disable analytics, or use the "--enable" flag if you want to enable analytics back again. In case you do not know the analytics current status, then you can append the "--status" flag to be aware of it.\n');
+                    this.log(`\nPlease append the ${(0, picocolors_1.blueBright)('--disable')} flag to the command if you prefer to disable analytics, or use the ${(0, picocolors_1.blueBright)('--enable')} flag if you want to enable analytics again. To check the current analytics status, use the ${(0, picocolors_1.blueBright)('--status')} flag.\n`);
                     return;
                 }
                 yield writeFile(analyticsConfigFile, JSON.stringify(analyticsConfigFileContent), { encoding: 'utf8' });
@@ -34,7 +35,7 @@ class Analytics extends base_1.default {
                         this.log('\nAnalytics are enabled.\n');
                     }
                     else {
-                        this.log('\nAnalytics are disabled. Please append the "--enable" flag to the command in case you prefer to enable analytics.\n');
+                        this.log(`\n${(0, picocolors_1.redBright)('Analytics are disabled.')} To enable analytics, use the ${(0, picocolors_1.blueBright)('--enable')} flag.\n`);
                     }
                     this.metricsMetadata.analytics_status_checked = flags.status;
                 }
@@ -42,13 +43,13 @@ class Analytics extends base_1.default {
             catch (e) {
                 switch (e.code) {
                     case 'ENOENT':
-                        this.error(`Unable to access the analytics configuration file. We tried to access the ".asyncapi-analytics" file in in the path "${analyticsConfigFile}" but the file could not be found.`);
+                        this.error(`Unable to access the analytics configuration file. We tried to access the ${(0, picocolors_1.blueBright)('.asyncapi-analytics')} file in the path "${(0, picocolors_1.blueBright)(analyticsConfigFile)}" but the file could not be found.`);
                         break;
                     case 'EEXIST':
-                        this.error(`Unable to update the analytics configuration file. We tried to update your ".asyncapi-analytics" file in the path "${analyticsConfigFile}" but the file does not exist.`);
+                        this.error(`Unable to update the analytics configuration file. We tried to update your ".asyncapi-analytics" file in the path "${(0, picocolors_1.blueBright)(analyticsConfigFile)}" but the file does not exist.`);
                         break;
                     default:
-                        this.error(`Unable to change your analytics configuration. Please check the following message for further info about the error:\n\n${e}`);
+                        this.error(`Unable to change your analytics configuration. Please check the following message for further info about the error:\n\n${(0, picocolors_1.redBright)(e)}`);
                 }
             }
         });

package/lib/commands/config/context/add.js

@@ -6,6 +6,7 @@ const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const context_error_1 = require("../../../core/errors/context-error");
 const context_flags_1 = require("../../../core/flags/config/context.flags");
+const picocolors_1 = require("picocolors");
 class ContextAdd extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -15,16 +16,15 @@ class ContextAdd extends base_1.default {
             const setAsCurrent = flags['set-current'];
             try {
                 yield (0, Context_1.addContext)(contextName, specFilePath);
-                this.log(`Added context "${contextName}".\n\nYou can set it as your current context: asyncapi config context use ${contextName}\nYou can use this context when needed by passing ${contextName} as a parameter: asyncapi validate ${contextName}`);
+                this.log(`🎉 Context ${(0, picocolors_1.blueBright)(contextName)} added successfully!\nYou can set it as your current context:\n  ${(0, picocolors_1.blueBright)('asyncapi')} ${(0, picocolors_1.blueBright)('config')} ${(0, picocolors_1.blueBright)('context')} ${(0, picocolors_1.blueBright)('use')} ${(0, picocolors_1.blueBright)(contextName)}\nYou can use this context when needed by passing ${(0, picocolors_1.blueBright)(contextName)} as a parameter:\n  ${(0, picocolors_1.blueBright)('asyncapi')} ${(0, picocolors_1.blueBright)('validate')} ${(0, picocolors_1.blueBright)(contextName)}`);
                 if (setAsCurrent) {
                     yield (0, Context_1.setCurrentContext)(contextName);
-                    this.log(`The newly added context "${contextName}", is set as your current context!`);
+                    this.log(`\nThe newly added context, ${(0, picocolors_1.blueBright)(contextName)}, is set as your current context!`);
                 }
             }
             catch (e) {
                 if (e instanceof (context_error_1.MissingContextFileError || context_error_1.ContextFileWrongFormatError)) {
-                    this.log('You have no context file configured. Run "asyncapi config context init" to initialize it.');
-                    return;
+                    this.error(`Unable to add context. You have no context file configured.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context init')} to initialize it.`);
                 }
                 throw e;
             }

package/lib/commands/config/context/current.js

@@ -5,6 +5,7 @@ const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const context_error_1 = require("../../../core/errors/context-error");
 const global_flags_1 = require("../../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class ContextCurrent extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -14,22 +15,19 @@ class ContextCurrent extends base_1.default {
             }
             catch (e) {
                 if (e instanceof (context_error_1.MissingContextFileError || context_error_1.ContextFileWrongFormatError)) {
-                    this.log('You have no context file configured. Run "asyncapi config context init" to initialize it.');
-                    return;
+                    this.error(`Unable to show current context. You have no context file configured.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context init')} to initialize it.`);
                 }
                 else if (e instanceof context_error_1.ContextFileEmptyError) {
-                    this.log(`Context file "${Context_1.CONTEXT_FILE_PATH}" is empty.`);
-                    return;
+                    this.error(`Context file ${(0, picocolors_1.blueBright)(Context_1.CONTEXT_FILE_PATH)} is empty.`);
                 }
                 else if (e instanceof context_error_1.ContextNotFoundError ||
                     (fileContent && !fileContent.current)) {
-                    this.log('No context is set as current. Run "asyncapi config context" to see all available options.');
-                    return;
+                    this.error(`No context is set as current.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context')} to see all available options.`);
                 }
                 throw e;
             }
             if (fileContent) {
-                this.log(`${fileContent.current}: ${fileContent.context}`);
+                this.log(`${(0, picocolors_1.blueBright)(fileContent.current)}: ${fileContent.context}`);
             }
         });
     }

package/lib/commands/config/context/edit.js

@@ -6,6 +6,7 @@ const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const context_error_1 = require("../../../core/errors/context-error");
 const global_flags_1 = require("../../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class ContextEdit extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -14,16 +15,14 @@ class ContextEdit extends base_1.default {
             const newSpecFilePath = args['new-spec-file-path'];
             try {
                 yield (0, Context_1.editContext)(contextName, newSpecFilePath);
-                this.log(`Edited context "${contextName}".\n\nYou can set it as your current context: asyncapi config context use ${contextName}\nYou can use this context when needed by passing ${contextName} as a parameter: asyncapi validate ${contextName}`);
+                this.log(`🎉 Context ${(0, picocolors_1.blueBright)(contextName)} edited successfully!\nYou can set it as your current context:\n  ${(0, picocolors_1.blueBright)('asyncapi')} ${(0, picocolors_1.blueBright)('config')} ${(0, picocolors_1.blueBright)('context')} ${(0, picocolors_1.blueBright)('use')} ${(0, picocolors_1.blueBright)(contextName)}\nYou can use this context when needed by passing ${(0, picocolors_1.blueBright)(contextName)} as a parameter:\n  ${(0, picocolors_1.blueBright)('asyncapi')} ${(0, picocolors_1.blueBright)('validate')} ${(0, picocolors_1.blueBright)(contextName)}`);
             }
             catch (e) {
                 if (e instanceof (context_error_1.MissingContextFileError || context_error_1.ContextFileWrongFormatError)) {
-                    this.log('You have no context file configured. Run "asyncapi config context init" to initialize it.');
-                    return;
+                    this.error(`Unable to edit context. You have no context file configured.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context init')} to initialize it.`);
                 }
                 else if (e instanceof context_error_1.ContextFileEmptyError) {
-                    this.log(`Context file "${Context_1.CONTEXT_FILE_PATH}" is empty.`);
-                    return;
+                    this.error(`Context file ${(0, picocolors_1.blueBright)(Context_1.CONTEXT_FILE_PATH)} is empty.`);
                 }
                 throw e;
             }

package/lib/commands/config/context/init.js

@@ -5,13 +5,14 @@ const core_1 = require("@oclif/core");
 const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const global_flags_1 = require("../../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class ContextInit extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             const { args } = yield this.parse(ContextInit);
             const contextFilePath = args['context-file-path'];
             const contextWritePath = yield (0, Context_1.initContext)(contextFilePath);
-            this.log(`Initialized context ${contextWritePath}`);
+            this.log(`🎉 Context initialized at ${(0, picocolors_1.blueBright)(contextWritePath)}`);
         });
     }
 }
@@ -19,9 +20,9 @@ exports.default = ContextInit;
 ContextInit.description = 'Initialize context';
 ContextInit.flags = (0, global_flags_1.helpFlag)();
 ContextInit.contextFilePathMessage = `Specify directory in which context file should be created:
-    - current directory          : asyncapi config context init . (default)
-    - root of current repository : asyncapi config context init ./
-    - user's home directory      : asyncapi config context init ~`;
+    - current directory          : ${(0, picocolors_1.blueBright)('asyncapi config context init .')}(default)
+    - root of current repository : ${(0, picocolors_1.blueBright)('asyncapi config context init ./ ')}
+    - user's home directory      : ${(0, picocolors_1.blueBright)('asyncapi config context init ~`')}`;
 ContextInit.args = {
     'context-file-path': core_1.Args.string({ description: `${ContextInit.contextFilePathMessage}`, required: false })
 };

package/lib/commands/config/context/list.js

@@ -5,24 +5,25 @@ const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const context_error_1 = require("../../../core/errors/context-error");
 const global_flags_1 = require("../../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class ContextList extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             try {
                 const fileContent = yield (0, Context_1.loadContextFile)();
                 if (yield (0, Context_1.isContextFileEmpty)(fileContent)) {
-                    this.log(`Context file "${Context_1.CONTEXT_FILE_PATH}" is empty.`);
+                    this.log(`Context file ${(0, picocolors_1.blueBright)(Context_1.CONTEXT_FILE_PATH)} is empty.`);
                     return;
                 }
                 if (fileContent) {
                     for (const [contextName, filePath] of Object.entries(fileContent.store)) {
-                        this.log(`${contextName}: ${filePath}`);
+                        this.log(`${(0, picocolors_1.blueBright)(contextName)}: ${filePath}`);
                     }
                 }
             }
             catch (e) {
                 if (e instanceof (context_error_1.MissingContextFileError || context_error_1.ContextFileWrongFormatError)) {
-                    this.log('You have no context file configured. Run "asyncapi config context init" to initialize it.');
+                    this.log(`Unable to list contexts. You have no context file configured.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context init')} to initialize it.\n`);
                     return;
                 }
                 throw e;

package/lib/commands/config/context/remove.js

@@ -6,6 +6,7 @@ const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const context_error_1 = require("../../../core/errors/context-error");
 const global_flags_1 = require("../../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class ContextRemove extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -13,16 +14,14 @@ class ContextRemove extends base_1.default {
             const contextName = args['context-name'];
             try {
                 yield (0, Context_1.removeContext)(contextName);
-                this.log(`${contextName} successfully deleted`);
+                this.log(`Context ${(0, picocolors_1.blueBright)(contextName)} removed successfully!\n`);
             }
             catch (e) {
                 if (e instanceof (context_error_1.MissingContextFileError || context_error_1.ContextFileWrongFormatError)) {
-                    this.log('You have no context file configured. Run "asyncapi config context init" to initialize it.');
-                    return;
+                    this.error(`Unable to remove context. You have no context file configured.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context init')} to initialize it.`);
                 }
                 else if (e instanceof context_error_1.ContextFileEmptyError) {
-                    this.log(`Context file "${Context_1.CONTEXT_FILE_PATH}" is empty.`);
-                    return;
+                    this.error(`Context file ${(0, picocolors_1.blueBright)(Context_1.CONTEXT_FILE_PATH)} is empty.`);
                 }
                 throw e;
             }

package/lib/commands/config/context/use.js

@@ -6,6 +6,7 @@ const base_1 = tslib_1.__importDefault(require("../../../core/base"));
 const Context_1 = require("../../../core/models/Context");
 const context_error_1 = require("../../../core/errors/context-error");
 const global_flags_1 = require("../../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class ContextUse extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -13,15 +14,14 @@ class ContextUse extends base_1.default {
             const contextName = args['context-name'];
             try {
                 yield (0, Context_1.setCurrentContext)(contextName);
-                this.log(`${contextName} is set as current`);
+                this.log(`Context ${(0, picocolors_1.blueBright)(contextName)} is now set as current.`);
             }
             catch (e) {
                 if (e instanceof (context_error_1.MissingContextFileError || context_error_1.ContextFileWrongFormatError)) {
-                    this.log('You have no context file configured. Run "asyncapi config context init" to initialize it.');
-                    return;
+                    this.error(`Unable to set the current context. You have no context file configured.\nRun ${(0, picocolors_1.blueBright)('asyncapi config context init')} to initialize it.`);
                 }
                 else if (e instanceof context_error_1.ContextFileEmptyError) {
-                    this.log(`Context file "${Context_1.CONTEXT_FILE_PATH}" is empty.`);
+                    this.error(`Context file ${(0, picocolors_1.blueBright)(Context_1.CONTEXT_FILE_PATH)} is empty.`);
                     return;
                 }
                 throw e;

package/lib/commands/config/versions.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const base_1 = tslib_1.__importDefault(require("../../core/base"));
 const global_flags_1 = require("../../core/flags/global.flags");
+const picocolors_1 = require("picocolors");
 class Versions extends base_1.default {
     run() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
@@ -29,7 +30,7 @@ class Versions extends base_1.default {
                 }
             }
             // Showing information available with `--version` flag.
-            this.log(this.config.userAgent);
+            this.log((0, picocolors_1.gray)(`\n${this.config.userAgent}\n`));
             // Iteration through the array containing all dependencies '@asyncapi/*'
             // along with their versions.
             for (let i = 0; i < dependencies.length; i++) {
@@ -47,7 +48,7 @@ class Versions extends base_1.default {
                     this.log(`  └${dependency}\n`);
                 }
             }
-            this.log(`Repository: ${this.config.pjson.homepage}`);
+            this.log(`Repository: ${(0, picocolors_1.blueBright)(this.config.pjson.homepage)}`);
         });
     }
 }

package/lib/commands/new/file.js

@@ -109,6 +109,7 @@ class NewFile extends base_1.default {
             fileName = fileName || DEFAULT_ASYNCAPI_FILE_NAME;
             selectedTemplate = selectedTemplate || DEFAULT_ASYNCAPI_TEMPLATE;
             yield this.createAsyncapiFile(fileName, selectedTemplate);
+            fileName = fileName.includes('.') ? fileName : `${fileName}.yaml`;
             if (openStudio) {
                 (0, Studio_1.start)(fileName, flags.port || Studio_1.DEFAULT_PORT);
             }
@@ -155,5 +156,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/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/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/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/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 {
@@ -95,9 +106,15 @@ function start(filePath, port = exports.DEFAULT_PORT) {
     });
     server.listen(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}`);
+        console.log(`🎉 Connected to Live Server running at ${(0, picocolors_1.blueBright)(url)}.`);
+        console.log(`🌐 Open this URL in your web browser: ${(0, picocolors_1.blueBright)(url)}`);
+        console.log(`🛑 If needed, press ${(0, picocolors_1.redBright)('Ctrl + C')} to stop the process.`);
+        if (filePath) {
+            console.log(`👁️ Watching changes on file ${(0, picocolors_1.blueBright)(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

@@ -1210,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": {
@@ -1340,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": {
@@ -1494,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": {
@@ -1506,6 +1512,7 @@
         },
         "file": {
           "char": "f",
+          "deprecated": true,
           "description": "path to the AsyncAPI file to link with Studio",
           "name": "file",
           "hasDynamicHelp": false,
@@ -1678,7 +1685,7 @@
       "aliases": [],
       "args": {
         "context-file-path": {
-          "description": "Specify directory in which context file should be created:\n    - current directory          : asyncapi config context init . (default)\n    - root of current repository : asyncapi config context init ./\n    - user's home directory      : asyncapi config context init ~",
+          "description": "Specify directory in which context file should be created:\n    - current directory          : \u001b[94masyncapi config context init .\u001b[39m(default)\n    - root of current repository : \u001b[94masyncapi config context init ./ \u001b[39m\n    - user's home directory      : \u001b[94masyncapi config context init ~`\u001b[39m",
           "name": "context-file-path",
           "required": false
         }
@@ -1700,7 +1707,7 @@
       "pluginName": "@asyncapi/cli",
       "pluginType": "core",
       "strict": true,
-      "contextFilePathMessage": "Specify directory in which context file should be created:\n    - current directory          : asyncapi config context init . (default)\n    - root of current repository : asyncapi config context init ./\n    - user's home directory      : asyncapi config context init ~",
+      "contextFilePathMessage": "Specify directory in which context file should be created:\n    - current directory          : \u001b[94masyncapi config context init .\u001b[39m(default)\n    - root of current repository : \u001b[94masyncapi config context init ./ \u001b[39m\n    - user's home directory      : \u001b[94masyncapi config context init ~`\u001b[39m",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -1810,5 +1817,5 @@
       ]
     }
   },
-  "version": "2.15.0"
+  "version": "2.16.1"
 }

package/package.json

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