@adobe/aio-cli-plugin-api-mesh 1.1.0 → 1.3.0

package/README.md

@@ -62,7 +62,7 @@ If you want to have custom configuration instead, please follow the steps below:
 2. Perform the following command to update the configuration
 
 ```
-aio config:set api-mesh.configPath <path_to_json_file>
+aio config:set api-mesh.cliConfig <path_to_json_file>
 ```
 
 # Commands
@@ -90,9 +90,13 @@ To submit a new source, please follow the instructions provided in the [Source R
 ## Commands
 
 ```
-aio api-mesh:source:get 
-NAME_OF_THE_SOURCE
-aio api-mesh:source:get NAME_OF_THE_SOURCE@VERSION_OF_THE_SOURCE
+
+aio api-mesh:source:install SOURCE_NAME
+aio api-mesh:source:install SOURCE_NAME -v VARIABLE_NAME=VARIABLE_VALUE
+aio api-mesh:source:install SOURCE_NAME -f PATH_TO_FILE_WITH_VARIABLES
+
+aio api-mesh:source:get SOURCE_NAME
+aio api-mesh:source:get SOURCE_NAME@VERSION_OF_THE_SOURCE
 aio api-mesh:source:get -m 
 aio api-mesh:source:discover
 ```

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"1.1.0","commands":{"PLUGINNAME":{"id":"PLUGINNAME","description":"Your description here","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"examples":["$ aio PLUGINNAME:some_command"],"flags":{"someflag":{"name":"someflag","type":"option","char":"f","description":"this is some flag"}},"args":[]},"api-mesh:create":{"id":"api-mesh:create","description":"Create a mesh with the given config.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false},"autoConfirmAction":{"name":"autoConfirmAction","type":"boolean","char":"c","description":"Auto confirm action prompt. CLI will not check for user approval before executing the action.","allowNo":false}},"args":[{"name":"file"}]},"api-mesh:delete":{"id":"api-mesh:delete","description":"Delete the config of a given mesh","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false},"autoConfirmAction":{"name":"autoConfirmAction","type":"boolean","char":"c","description":"Auto confirm action prompt. CLI will not check for user approval before executing the action.","allowNo":false}},"args":[]},"api-mesh:describe":{"id":"api-mesh:describe","description":"Get details of a mesh","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false}},"args":[]},"api-mesh:get":{"id":"api-mesh:get","description":"Get the config of a given mesh","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false}},"args":[{"name":"file"}]},"api-mesh:update":{"id":"api-mesh:update","description":"Update a mesh with the given config.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false},"autoConfirmAction":{"name":"autoConfirmAction","type":"boolean","char":"c","description":"Auto confirm action prompt. CLI will not check for user approval before executing the action.","allowNo":false}},"args":[{"name":"file"}]},"api-mesh:source:discover":{"id":"api-mesh:source:discover","description":"Return the list of avaliable sources","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{},"args":[]},"api-mesh:source:get":{"id":"api-mesh:source:get","description":"Command returns the content of a specific source.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"examples":["$ aio api-mesh:source:get <version>@<source_name>","$ aio api-mesh:source:get <source_name>","$ aio api-mesh:source:get -m"],"flags":{"source":{"name":"source","type":"option","char":"s","description":"Source name"},"multiple":{"name":"multiple","type":"boolean","char":"m","description":"Select multiple sources","allowNo":false}},"args":[]}}}
+{"version":"1.3.0","commands":{"PLUGINNAME":{"id":"PLUGINNAME","description":"Your description here","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"examples":["$ aio PLUGINNAME:some_command"],"flags":{"someflag":{"name":"someflag","type":"option","char":"f","description":"this is some flag"}},"args":[]},"api-mesh:create":{"id":"api-mesh:create","description":"Create a mesh with the given config.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false},"autoConfirmAction":{"name":"autoConfirmAction","type":"boolean","char":"c","description":"Auto confirm action prompt. CLI will not check for user approval before executing the action.","allowNo":false}},"args":[{"name":"file"}]},"api-mesh:delete":{"id":"api-mesh:delete","description":"Delete the config of a given mesh","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false},"autoConfirmAction":{"name":"autoConfirmAction","type":"boolean","char":"c","description":"Auto confirm action prompt. CLI will not check for user approval before executing the action.","allowNo":false}},"args":[]},"api-mesh:describe":{"id":"api-mesh:describe","description":"Get details of a mesh","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false}},"args":[]},"api-mesh:get":{"id":"api-mesh:get","description":"Get the config of a given mesh","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false}},"args":[{"name":"file"}]},"api-mesh:update":{"id":"api-mesh:update","description":"Update a mesh with the given config.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false},"autoConfirmAction":{"name":"autoConfirmAction","type":"boolean","char":"c","description":"Auto confirm action prompt. CLI will not check for user approval before executing the action.","allowNo":false}},"args":[{"name":"file"}]},"api-mesh:source:discover":{"id":"api-mesh:source:discover","description":"Return the list of avaliable sources","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"flags":{},"args":[]},"api-mesh:source:get":{"id":"api-mesh:source:get","description":"Command returns the content of a specific source.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"examples":["$ aio api-mesh:source:get <version>@<source_name>","$ aio api-mesh:source:get <source_name>","$ aio api-mesh:source:get -m"],"flags":{"source":{"name":"source","type":"option","char":"s","description":"Source name"},"multiple":{"name":"multiple","type":"boolean","char":"m","description":"Select multiple sources","allowNo":false}},"args":[]},"api-mesh:source:install":{"id":"api-mesh:source:install","description":"Command to install the source to your API mesh.","pluginName":"@adobe/aio-cli-plugin-api-mesh","pluginType":"core","aliases":[],"examples":["$ aio api-mesh:source:install <version>@<source_name>","$ aio api-mesh:source:install <source_name> -v <variable_name>=<variable_value>","$ aio api-mesh:source:install <source_name> -f <path_to_variables_file>"],"flags":{"variable":{"name":"variable","type":"option","char":"v","description":"Variables required for the source"},"variable-file":{"name":"variable-file","type":"option","char":"f","description":"Variables file path"},"ignoreCache":{"name":"ignoreCache","type":"boolean","char":"i","description":"Ignore cache and force manual org -> project -> workspace selection","allowNo":false}},"args":[{"name":"source"}]}}}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@adobe/aio-cli-plugin-api-mesh",
-	"version": "1.1.0",
+	"version": "1.3.0",
 	"publishConfig": {
 		"access": "public"
 	},
@@ -18,6 +18,7 @@
 		"chalk": "^4.1.0",
 		"dotenv": "^16.0.1",
 		"inquirer": "^8.2.4",
+		"json-interpolate": "^1.0.3",
 		"node-clipboardy": "^1.0.3",
 		"pino": "^7.9.2",
 		"pino-pretty": "^7.6.0",

package/src/commands/api-mesh/__tests__/describe.test.js

@@ -89,26 +89,19 @@ describe('describe command tests', () => {
 	});
 
 	test('should error if describe api has failed', async () => {
-		describeMesh.mockRejectedValueOnce(new Error('describe api failed'));
+		describeMesh.mockRejectedValueOnce(new Error('Describe api failed'));
 
 		const runResult = DescribeCommand.run();
 
 		await expect(runResult).rejects.toEqual(
 			new Error(
-				'Unable to get mesh details. Please check the details and try again. If the error persists please contact support. RequestId: dummy_request_id',
+				'Describe api failed Please check the details and try again. If the error persists please contact support. RequestId: dummy_request_id',
 			),
 		);
-		expect(logSpy.mock.calls).toMatchInlineSnapshot(`
-		Array [
-		  Array [
-		    "describe api failed",
-		  ],
-		]
-	`);
 		expect(errorLogSpy.mock.calls).toMatchInlineSnapshot(`
 		Array [
 		  Array [
-		    "Unable to get mesh details. Please check the details and try again. If the error persists please contact support. RequestId: dummy_request_id",
+		    "Describe api failed Please check the details and try again. If the error persists please contact support. RequestId: dummy_request_id",
 		  ],
 		]
 	`);
@@ -124,13 +117,6 @@ describe('describe command tests', () => {
 				'Unable to get mesh details. Please check the details and try again. If the error persists please contact support. RequestId: dummy_request_id',
 			),
 		);
-		expect(logSpy.mock.calls).toMatchInlineSnapshot(`
-		Array [
-		  Array [
-		    "Unable to get mesh details",
-		  ],
-		]
-	`);
 		expect(errorLogSpy.mock.calls).toMatchInlineSnapshot(`
 		Array [
 		  Array [

package/src/commands/api-mesh/describe.js

@@ -68,13 +68,15 @@ class DescribeCommand extends Command {
 					);
 				}
 			} else {
-				throw new Error(`Unable to get mesh details`);
+				throw new Error(`Unable to get mesh details.`);
 			}
 		} catch (error) {
-			this.log(error.message);
-
 			this.error(
-				`Unable to get mesh details. Please check the details and try again. If the error persists please contact support. RequestId: ${global.requestId}`,
+				`${
+					error.message || 'Unable to get mesh details.'
+				} Please check the details and try again. If the error persists please contact support. RequestId: ${
+					global.requestId
+				}`,
 			);
 		}
 	}

package/src/commands/api-mesh/source/__fixtures__/0.0.1-test-03.json

@@ -0,0 +1,40 @@
+{
+	"name": "Test 03",
+	"version": "0.0.1",
+	"description": "Mock for variable injection",
+	"author": "VladimirZaets",
+	"variables": {
+		"ENDPOINT_URL": {
+			"name": "Test API",
+			"description": "This URL will be used to query the third-party API",
+			"type": "string"
+		}
+	},
+	"provider": {
+		"name": "Commerce",
+		"handler": {
+			"graphql": {
+				"endpoint": "${ENDPOINT_URL}"
+			}
+		},
+		"transforms": [
+			{
+				"rename": {
+					"mode": "bare | wrap",
+					"renames": [
+						{
+							"from": {
+								"type": "Query",
+								"field": "compareList"
+							},
+							"to": {
+								"type": "Query",
+								"field": "productCompareList"
+							}
+						}
+					]
+				}
+			}
+		]
+	}
+}

package/src/commands/api-mesh/source/__fixtures__/connectors-metadata.json

@@ -12,5 +12,12 @@
 		"author": "VZ",
 		"latest": "0.0.1",
 		"versions": ["0.0.1"]
+	},
+	"test-03": {
+		"name": "test-03",
+		"description": "Mock for variable injection",
+		"author": "VladimirZaets",
+		"latest": "0.0.1",
+		"versions": ["0.0.1"]
 	}
 }

package/src/commands/api-mesh/source/__fixtures__/variables-file-invalid.json

@@ -0,0 +1,3 @@
+{
+	"ENDPOINT_URL": 1
+}

package/src/commands/api-mesh/source/__tests__/install.test.js

@@ -0,0 +1,137 @@
+/*
+Copyright 2021 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+const mockMetadataFixture = require('../__fixtures__/connectors-metadata.json');
+const mockSourceTest01v1Fixture = require('../__fixtures__/0.0.1-test-01.json');
+const mockSourceTest02v1Fixture = require('../__fixtures__/0.0.1-test-02.json');
+const mockSourceTest03v1Fixture = require('../__fixtures__/0.0.1-test-03.json');
+const mockAdapter = require('source-registry-storage-adapter');
+const chalk = require('chalk');
+const { initSdk, initRequestId, promptInput } = require('../../../../helpers');
+const mockSources = { '0.0.1-test-03': mockSourceTest03v1Fixture };
+jest.mock('source-registry-storage-adapter');
+jest.mock('../../../../helpers');
+const InstallCommand = require('../install');
+const { getMeshId, getMesh, updateMesh } = require('../../../../lib/devConsole');
+const mockGetMeshConfig = require('../../../__fixtures__/sample_mesh.json');
+const selectedOrg = { id: '1234', code: 'CODE1234@AdobeOrg', name: 'ORG01', type: 'entp' };
+const selectedProject = { id: '5678', title: 'Project01' };
+const selectedWorkspace = { id: '123456789', title: 'Workspace01' };
+global.requestId = 'dummy_request_id';
+jest.mock('../../../../lib/devConsole');
+mockAdapter.mockImplementation(() => ({
+	get: jest.fn().mockResolvedValue(mockSources[`0.0.1-test-03`]),
+	getList: jest.fn().mockImplementation(() => mockMetadataFixture),
+}));
+getMeshId.mockResolvedValue('dummy_meshId');
+getMesh.mockResolvedValue(mockGetMeshConfig);
+updateMesh.mockResolvedValue({ status: 'success' });
+
+initSdk.mockResolvedValue({
+	imsOrgId: selectedOrg.id,
+	projectId: selectedProject.id,
+	workspaceId: selectedWorkspace.id,
+});
+initRequestId.mockResolvedValue({});
+promptInput.mockResolvedValueOnce('test-03');
+
+describe('source:install command tests', () => {
+	test('Snapshot install command description', () => {
+		expect(InstallCommand.description).toMatchInlineSnapshot(
+			`"Command to install the source to your API mesh."`,
+		);
+		expect(InstallCommand.flags).toMatchInlineSnapshot(`
+		Object {
+		  "ignoreCache": Object {
+		    "allowNo": false,
+		    "char": "i",
+		    "default": false,
+		    "description": "Ignore cache and force manual org -> project -> workspace selection",
+		    "parse": [Function],
+		    "type": "boolean",
+		  },
+		  "variable": Object {
+		    "char": "v",
+		    "description": "Variables required for the source",
+		    "input": Array [],
+		    "multiple": true,
+		    "parse": [Function],
+		    "type": "option",
+		  },
+		  "variable-file": Object {
+		    "char": "f",
+		    "description": "Variables file path",
+		    "input": Array [],
+		    "multiple": false,
+		    "parse": [Function],
+		    "type": "option",
+		  },
+		}
+	`);
+		expect(InstallCommand.aliases).toMatchInlineSnapshot(`Array []`);
+	});
+	test('Check executing without parameters', async () => {
+		await InstallCommand.run([]).catch(err => {
+			expect(err.message).toEqual(
+				`The "aio api-mesh:source:install" command requires additional parameters` +
+					`\nUse "aio api-mesh:source:install --help" to see parameters details.`,
+			);
+		});
+	});
+	test('Check executing with invalid file parameter', async () => {
+		await InstallCommand.run(['test-03', '-f=notexist.json']).catch(err => {
+			expect(err.message).toEqual(
+				`Something went wrong trying to read the variables file.` +
+					`\nENOENT: no such file or directory, open 'notexist.json'`,
+			);
+		});
+	});
+	test('Check executing with invalid variable type', async () => {
+		const path = `-f=${__dirname}/../__fixtures__/variables-file-invalid.json`;
+		await InstallCommand.run(['test-03', path]).catch(err => {
+			expect(err.message).toEqual(
+				chalk.red(
+					`The next variables has invalid type.\nVariable: ENDPOINT_URL\nRequested type: string`,
+				),
+			);
+		});
+	});
+	test('Check executing without passing variables', async () => {
+		await InstallCommand.run(['test-03']);
+		expect(promptInput).toHaveBeenCalledTimes(1);
+	});
+	test('Check executing without passing variables and input data', async () => {
+		await InstallCommand.run(['test-03']).catch(err => {
+			expect(err.message).toEqual(
+				chalk.red(
+					`The next variables has invalid type.\nVariable: ENDPOINT_URL\nRequested type: string`,
+				),
+			);
+		});
+		expect(promptInput).toHaveBeenCalledTimes(1);
+	});
+	test('Check executing with passing variables in CLI', async () => {
+		const parsed =
+			'{"name":"Test 03","version":"0.0.1","description":"Mock for variable injection","author":"VladimirZaets","variables":{"ENDPOINT_URL":{"name":"Test API","description":"This URL will be used to query the third-party API","type":"string"}},"provider":{"name":"Commerce","handler":{"graphql":{"endpoint":"https:www.myendpoint.com/api"}},"transforms":[{"rename":{"mode":"bare | wrap","renames":[{"from":{"type":"Query","field":"compareList"},"to":{"type":"Query","field":"productCompareList"}}]}}]}}';
+		const res = { ...mockGetMeshConfig };
+		res.meshConfig.sources.push(JSON.parse(parsed));
+		await InstallCommand.run(['test-03', '-v ENDPOINT_URL=https:www.myendpoint.com/api']);
+		expect(promptInput).toHaveBeenCalledTimes(0);
+		expect(updateMesh).toHaveBeenCalledWith(
+			selectedOrg.id,
+			selectedProject.id,
+			selectedWorkspace.id,
+			'dummy_meshId',
+			res,
+		);
+	});
+});

package/src/commands/api-mesh/source/install.js

@@ -0,0 +1,269 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+const { Command, Flags } = require('@oclif/core');
+const SourceRegistryStorage = require('source-registry-storage-adapter');
+const { promptConfirm, promptInput, initRequestId, initSdk } = require('../../../helpers');
+const { ignoreCacheFlag } = require('../../../utils');
+const config = require('@adobe/aio-lib-core-config');
+const logger = require('../../../classes/logger');
+const { readFile } = require('fs/promises');
+const chalk = require('chalk');
+const { getMeshId, getMesh, updateMesh } = require('../../../lib/devConsole');
+const JsonInterpolate = require('json-interpolate');
+
+class InstallCommand extends Command {
+	static args = [{ name: 'source' }];
+
+	constructor() {
+		super(...arguments);
+		this.sourceRegistryStorage = new SourceRegistryStorage(
+			config.get('api-mesh.sourceRegistry.path'),
+		);
+	}
+
+	async run() {
+		const { flags, args } = await this.parse(InstallCommand);
+		await initRequestId();
+		logger.info(`RequestId: ${global.requestId}`);
+		const ignoreCache = await flags.ignoreCache;
+		const { imsOrgId, projectId, workspaceId } = await initSdk({ ignoreCache });
+		const filepath = flags['variable-file'];
+		let variables = flags.variable
+			? flags.variable.reduce((obj, val) => {
+					const splited = val.split('=');
+					obj[splited[0].trim()] = splited[1].trim();
+					return obj;
+			  }, {})
+			: {};
+		if (filepath) {
+			try {
+				variables = { ...variables, ...JSON.parse(await readFile(filepath, 'utf8')) };
+			} catch (e) {
+				this.error(`Something went wrong trying to read the variables file.` + `\n${e.message}`);
+			}
+		}
+
+		let meshId = null;
+		if (!args.source && !flags.source) {
+			this.error(
+				`The "aio api-mesh:source:install" command requires additional parameters` +
+					`\nUse "aio api-mesh:source:install --help" to see parameters details.`,
+			);
+		}
+		let sourceProviders;
+		try {
+			sourceProviders = await this.sourceRegistryStorage.getList();
+		} catch (err) {
+			this.error(`Cannot get the list of sources: ${err}. RequestId: ${global.requestId}`);
+		}
+		const sources = flags.source ? flags.source : [args.source];
+		const sourceConfigs = {sources: [], files: {}};
+		for (const source of sources) {
+			let [name, version] = source.split('@');
+			const normalizedName = this.normalizeName(name);
+			if (!sourceProviders[normalizedName]) {
+				this.error(
+					chalk.red(
+						`The source named "${name}" doesn't exist.` +
+							`\nUse "aio api-mesh:source:discover" command to see avaliable sources.`,
+					),
+				);
+			}
+			version = version || sourceProviders[normalizedName].latest;
+			if (!sourceProviders[normalizedName].versions.includes(version)) {
+				this.error(
+					chalk.red(
+						`The version "${version}" for source name "${name}" doesn't exist.` +
+							`\nUse "aio api-mesh:source:discover" command to see avaliable source versions.`,
+					),
+				);
+			}
+			const sourceConfig = await this.sourceRegistryStorage.get(name, version);
+			const jsonInterpolate = new JsonInterpolate({ variablesSchema: sourceConfig.variables });
+			const sourceProviderString = JSON.stringify(sourceConfig.provider);
+			const sourceVariables = jsonInterpolate.getJsonVariables(sourceProviderString);
+			const missedVariables = jsonInterpolate.getMissedVariables(variables, sourceVariables);
+			for (const missedVariable of missedVariables) {
+				variables[missedVariable.name] = await promptInput(
+					`Enter the value for variable ${missedVariable.name}:`,
+				);
+			}
+
+			const { error, data } = jsonInterpolate.interpolate(
+				JSON.stringify(sourceConfig.provider),
+				variables,				
+			);
+			if (error) {
+				this.error(chalk.red(`${error.message}\n${error.list.map(err => err.message).join('\n')}`));
+			}
+			
+			sourceConfigs.sources.push(JSON.parse(data));
+			sourceConfigs.files[sourceConfig.provider.name] = sourceConfig.files;
+		}
+
+		try {
+			meshId = await getMeshId(imsOrgId, projectId, workspaceId);
+		} catch (err) {
+			this.error(
+				`Unable to get mesh ID. Please check the details and try again. RequestId: ${global.requestId}`,
+			);
+		}
+
+		if (!meshId) {
+			this.error(
+				`Unable to get mesh config. No mesh found for Org(${imsOrgId}) -> Project(${projectId}) -> Workspace(${workspaceId}). Please check the details and try again.`,
+			);
+		}
+
+		try {
+			const mesh = await getMesh(imsOrgId, projectId, workspaceId, meshId);
+
+			if (!mesh) {
+				this.error(
+					`Unable to get mesh with the ID ${meshId}. Please check the mesh ID and try again. RequestId: ${global.requestId}`,
+					{ exit: false },
+				);
+			}
+			const verifiedSources = this.verifySourceAlreadyExists(
+				mesh.meshConfig.sources,
+				sourceConfigs.sources,
+			);			
+
+			let override = false;
+			if (verifiedSources.installed.length) {
+				override = await promptConfirm(
+					`The following sources are already installed: ${verifiedSources.installed
+						.map(source => source.name)
+						.join(', ')}.
+                    Do you want to override?`,
+				);
+			}			
+			
+			const uniqueFiles = this.getSourceFiles(verifiedSources.unique.map(source => source.name), sourceConfigs.files);
+			const installedFiles = this.getSourceFiles(verifiedSources.installed.map(source => source.name), sourceConfigs.files);
+			let meshConfigFiles = mesh.meshConfig.files || [];
+
+			if (override) {
+				const installedMap = verifiedSources.installed.reduce((obj, source) => {
+					obj[source.name] = true;
+					return obj
+				}, {});
+				
+				mesh.meshConfig.sources = [
+					...mesh.meshConfig.sources.filter(source => !installedMap[source.name]),
+					...verifiedSources.installed
+				];
+
+				const installedFilesMap = installedFiles.reduce((obj, file) => {
+					obj[file.path] = true;
+					return obj
+				}, {});
+
+				meshConfigFiles = [
+					...meshConfigFiles.filter(file => !installedFilesMap[file.path]),
+					...installedFiles
+				];
+			}
+
+			mesh.meshConfig.sources = [
+				...mesh.meshConfig.sources,
+				...verifiedSources.unique
+			]
+			
+			meshConfigFiles = [
+				...meshConfigFiles,
+				...uniqueFiles
+			]					
+			
+			if (meshConfigFiles.length) {
+				mesh.meshConfig.files = meshConfigFiles
+			}
+
+			try {
+				const response = await updateMesh(imsOrgId, projectId, workspaceId, meshId, {
+					meshConfig: mesh.meshConfig,
+				});
+
+				this.log('Successfully updated the mesh with the id: %s', meshId);
+
+				return response;
+			} catch (error) {
+				this.log(error.message);
+
+				this.error(
+					`Unable to update the mesh. Please check the mesh configuration file and try again. If the error persists please contact support. RequestId: ${global.requestId}`,
+				);
+			}
+
+			return mesh;
+		} catch (error) {
+			this.log(error.message);
+			this.error(
+				`Unable to get mesh. Please check the details and try again. If the error persists please contact support. RequestId: ${global.requestId}`,
+			);
+		}
+	}
+
+	normalizeName(name) {
+		return name.toLowerCase().split(' ').join('-');
+	}
+
+	getSourceFiles(sourcesList, filesList) {
+		let result = [];
+		for (const source of sourcesList) {
+			if (Array.isArray(filesList[source])) {
+				result = [...result, ...filesList[source]]
+			}
+		}
+		return result;
+	}
+
+	verifySourceAlreadyExists(meshSources, installSources) {
+		const alreadyInstalledSources = [];
+		const uniqueSourcesToInstall = [];
+		installSources.forEach(installSource => {
+			const source = meshSources.find(meshSource => meshSource.name === installSource.name);
+			if (source) {
+				alreadyInstalledSources.push(source);
+			} else {
+				uniqueSourcesToInstall.push(installSource);
+			}
+		});
+		return {
+			installed: alreadyInstalledSources,
+			unique: uniqueSourcesToInstall,
+		};
+	}
+}
+
+InstallCommand.flags = {
+	'variable': Flags.string({
+		char: 'v',
+		description: 'Variables required for the source',
+		multiple: true,
+	}),
+	'variable-file': Flags.string({
+		char: 'f',
+		description: 'Variables file path',
+	}),
+	'ignoreCache': ignoreCacheFlag,
+};
+
+InstallCommand.description = 'Command to install the source to your API mesh.';
+InstallCommand.examples = [
+	'$ aio api-mesh:source:install <version>@<source_name>',
+	'$ aio api-mesh:source:install <source_name> -v <variable_name>=<variable_value>',
+	'$ aio api-mesh:source:install <source_name> -f <path_to_variables_file>',
+];
+
+module.exports = InstallCommand;

package/src/helpers.js

@@ -26,49 +26,103 @@ const { objToString } = require('./utils');
 
 const { DEV_CONSOLE_BASE_URL, DEV_CONSOLE_API_KEY, AIO_CLI_API_KEY } = CONSTANTS;
 
+async function getDevConsoleConfigFromFile(configFilePath) {
+	try {
+		if (!fs.existsSync(configFilePath)) {
+			throw new Error(
+				`Config file does not exist. Please run the command: aio config:set api-mesh.configPath <path_to_json_file> with a valid file.`,
+			);
+		}
+
+		const data = JSON.parse(fs.readFileSync(configFilePath, { encoding: 'utf8', flag: 'r' }));
+
+		if (!data.baseUrl || !data.apiKey) {
+			throw new Error(
+				'Invalid config file. Please validate the file contents and try again. Config file must contain baseUrl and apiKey.',
+			);
+		}
+
+		const baseUrl = data.baseUrl.endsWith('/')
+			? data.baseUrl.slice(0, data.baseUrl.length - 1)
+			: data.baseUrl;
+
+		const config = {
+			baseUrl: baseUrl,
+			accessToken: (await getLibConsoleCLI()).accessToken,
+			apiKey: data.apiKey,
+		};
+
+		logger.debug(`Using cli config from ${configFilePath}: ${objToString(config)}`);
+
+		return config;
+	} catch (error) {
+		logger.error(
+			'Please run the command: aio config:set api-mesh.configPath <path_to_json_file> with a valid config file.',
+		);
+
+		throw new Error(error);
+	}
+}
+
+async function getDevConsoleConfigFromObject(configObject) {
+	const { baseUrl, apiKey } = configObject;
+	const config = {
+		baseUrl,
+		accessToken: (await getLibConsoleCLI()).accessToken,
+		apiKey,
+	};
+
+	logger.debug(`Using cli config: ${objToString(config)}`);
+
+	return config;
+}
+
 /**
  * @returns {any} Returns a config object or null
  */
 async function getDevConsoleConfig() {
-	const configFile = Config.get('api-mesh.configPath');
+	const configFileOrObject = Config.get('api-mesh.cliConfig');
+
+	/**
+	 * Old legacy option, needs to be deprecated
+	 */
+	const configPath = Config.get('api-mesh.configPath');
+	if (configPath) {
+		if (configFileOrObject) {
+			throw new Error(
+				'Found both cliConfig and configPath in api-mesh config. Please consider using only cliConfig.',
+			);
+		} else {
+			console.warn(
+				'Please consider using cliConfig instead of configPath on api-mesh config. configPath will be deprecated soon.',
+			);
+			logger.warn(
+				'Please consider using cliConfig instead of configPath on api-mesh config. configPath will be deprecated soon.',
+			);
 
-	if (!configFile) {
-		return {
+			return await getDevConsoleConfigFromFile(configPath);
+		}
+	}
+
+	if (!configFileOrObject) {
+		const config = {
 			baseUrl: DEV_CONSOLE_BASE_URL,
 			accessToken: (await getLibConsoleCLI()).accessToken,
 			apiKey: DEV_CONSOLE_API_KEY,
 		};
-	} else {
-		try {
-			if (!fs.existsSync(configFile)) {
-				throw new Error(
-					`Config file does not exist. Please run the command: aio config:set api-mesh.configPath <path_to_json_file> with a valid file.`,
-				);
-			}
-
-			const data = JSON.parse(fs.readFileSync(configFile, { encoding: 'utf8', flag: 'r' }));
-
-			if (!data.baseUrl || !data.apiKey) {
-				throw new Error(
-					'Invalid config file. Please validate the file contents and try again. Config file must contain baseUrl and apiKey.',
-				);
-			}
 
-			const baseUrl = data.baseUrl.endsWith('/')
-				? data.baseUrl.slice(0, data.baseUrl.length - 1)
-				: data.baseUrl;
+		logger.debug(`No cli config found. Using defaults: ${objToString(config)}`);
 
-			return {
-				baseUrl: baseUrl,
-				accessToken: (await getLibConsoleCLI()).accessToken,
-				apiKey: data.apiKey,
-			};
-		} catch (error) {
-			logger.error(
-				'Please run the command: aio config:set api-mesh.configPath <path_to_json_file> with a valid config file.',
+		return config;
+	} else {
+		if (typeof configFileOrObject === 'object') {
+			return getDevConsoleConfigFromObject(configFileOrObject);
+		} else if (typeof configFileOrObject === 'string') {
+			return await getDevConsoleConfigFromFile(configFileOrObject);
+		} else {
+			throw new Error(
+				'Invalid config. Please validate and try again. Config should be a JSON object or a JSON file with baseUrl and apiKey.',
 			);
-
-			throw new Error(error);
 		}
 	}
 }
@@ -380,7 +434,27 @@ async function promptSelect(message, choices) {
 	return selected.item;
 }
 
+/**
+ * Function to run the CLI selectable list
+ *
+ * @param {string} message - prompt message
+ * @param {object[]} choices - list of options
+ * @returns {object[]} - selected options
+ */
+ async function promptInput(message) {
+	const selected = await inquirer.prompt([
+		{
+			name: 'item',
+			message: message,
+			type: 'input',
+		},
+	]);
+
+	return selected.item;
+}
+
 module.exports = {
+	promptInput,
 	promptConfirm,
 	getLibConsoleCLI,
 	getDevConsoleConfig,