@adobe/aio-cli-plugin-api-mesh 1.2.0 → 1.5.0

package/README.md

@@ -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.2.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.5.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},"json":{"name":"json","type":"boolean","description":"Output JSON","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":{"confirm":{"name":"confirm","type":"boolean","char":"c","description":"Auto confirm install action prompt. CLI will not check ask user to install source.","allowNo":false}},"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 -s=<version>@<source_name>","$ aio api-mesh:source:get -s<source_name>","$ aio api-mesh:source:get -m"],"flags":{"confirm":{"name":"confirm","type":"boolean","char":"c","description":"Auto confirm print action prompt. CLI will not check ask user to print source.","allowNo":false},"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":{"source":{"name":"source","type":"option","char":"s","description":"Source name"},"confirm":{"name":"confirm","type":"boolean","char":"c","description":"Auto confirm override action prompt. CLI will not check ask user to override source.","allowNo":false},"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.2.0",
+	"version": "1.5.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",
@@ -82,7 +83,7 @@
 		"format": "prettier --check \"./**/*.{ts,tsx,js,css,json,md}\"",
 		"format:fix": "prettier --write  \"./**/*.{ts,tsx,js,css,json,md}\""
 	},
-	"description": "Basic working repo structure for Adobe teams to use as a starting point for their own plugins, and available as a github template to the @adobe github org.",
+	"description": "Adobe I/O CLI plugin to develop and manage API mesh sources",
 	"directories": {
 		"test": "test"
 	},

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

@@ -117,6 +117,13 @@ describe('create command tests', () => {
 		    "parse": [Function],
 		    "type": "boolean",
 		  },
+		  "json": Object {
+		    "allowNo": false,
+		    "default": false,
+		    "description": "Output JSON",
+		    "parse": [Function],
+		    "type": "boolean",
+		  },
 		}
 	`);
 		expect(CreateCommand.aliases).toMatchInlineSnapshot(`Array []`);
@@ -485,4 +492,18 @@ describe('create command tests', () => {
 	`);
 		expect(errorLogSpy.mock.calls).toMatchInlineSnapshot(`Array []`);
 	});
+
+	test('must return proper object structure used by adobe/generator-app-api-mesh', async () => {
+		parseSpy.mockResolvedValueOnce({
+			args: { file: 'src/commands/__fixtures__/sample_mesh.json' },
+			flags: {
+				json: Promise.resolve(true)
+			},
+		});
+		const output = await CreateCommand.run()
+		expect(output).toHaveProperty('mesh')
+		expect(output).toHaveProperty('adobeIdIntegrationsForWorkspace')
+		expect(output.mesh).toEqual(expect.objectContaining({ meshId: 'dummy_mesh_id' }));
+		expect(output.adobeIdIntegrationsForWorkspace).toEqual(expect.objectContaining({ apiKey: 'dummy_api_key' })); 
+	});
 });

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

@@ -9,13 +9,13 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 
-const { Command } = require('@oclif/command');
+const { Command } = require('@oclif/core');
 const { readFile } = require('fs/promises');
 
 const { initSdk, initRequestId, promptConfirm } = require('../../helpers');
 const logger = require('../../classes/logger');
 const CONSTANTS = require('../../constants');
-const { ignoreCacheFlag, autoConfirmActionFlag } = require('../../utils');
+const { ignoreCacheFlag, autoConfirmActionFlag, jsonFlag } = require('../../utils');
 const {
 	createMesh,
 	createAPIMeshCredentials,
@@ -31,8 +31,11 @@ class CreateCommand extends Command {
 	static flags = {
 		ignoreCache: ignoreCacheFlag,
 		autoConfirmAction: autoConfirmActionFlag,
+		json: jsonFlag
 	};
 
+	static enableJsonFlag = true
+
 	async run() {
 		await initRequestId();
 
@@ -116,11 +119,12 @@ class CreateCommand extends Command {
 					} else {
 						this.log('Unable to create API Key');
 					}
-
+                    // Do not remove or rename return values.
+					// Template adobe/generator-app-api-mesh relies on "mesh" & "adobeIdIntegrationsForWorkspace" obj structure
 					return {
 						adobeIdIntegrationsForWorkspace,
 						sdkList,
-						mesh,
+						mesh
 					};
 				} else {
 					this.error(`Unable to create a mesh. Please try again. 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__/discover.test.js

@@ -12,10 +12,10 @@ governing permissions and limitations under the License.
 
 const mockMetadataFixture = require('../__fixtures__/connectors-metadata.json');
 const mockAdapter = require('source-registry-storage-adapter');
-const { promptConfirm } = require('../../../../helpers');
-const GetCommand = require('../get');
+const { promptConfirm, promptMultiselect } = require('../../../../helpers');
 const { CliUx } = require('@oclif/core');
 const DiscoverCommand = require('../discover');
+const InstallCommand = require('../install');
 jest.mock('source-registry-storage-adapter');
 jest.mock('../../../../helpers');
 jest.mock('../get');
@@ -43,16 +43,17 @@ describe('source:discover command tests', () => {
 		await DiscoverCommand.run([]);
 		expect(CliUx.Table.table).toHaveBeenCalledTimes(1);
 	});
-	test('Check that "source:get -m" command is called', async () => {
-		GetCommand.run = jest.fn().mockImplementation(() => 'source:get -m');
+	test('Check that "source:install" command is called', async () => {
+		InstallCommand.run = jest.fn().mockImplementation(() => 'source:install');
 		promptConfirm.mockResolvedValue(true);
+		promptMultiselect.mockResolvedValue([mockMetadataFixture['test-01']])
 		await DiscoverCommand.run([]);
-		expect(GetCommand.run).toHaveBeenCalledTimes(1);
+		expect(InstallCommand.run).toHaveBeenCalledTimes(1);
 	});
-	test('Check that "source:get -m" command is not called', async () => {
-		GetCommand.run = jest.fn().mockImplementation(() => 'source:get -m');
+	test('Check that "source:install" command is not called', async () => {
+		InstallCommand.run = jest.fn().mockImplementation(() => 'source:install');
 		promptConfirm.mockResolvedValue(false);
 		await DiscoverCommand.run([]);
-		expect(GetCommand.run).toHaveBeenCalledTimes(0);
+		expect(InstallCommand.run).toHaveBeenCalledTimes(0);
 	});
 });

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

@@ -30,6 +30,9 @@ const expectedResultForSuccessScenarios = JSON.stringify(
 	null,
 	4,
 );
+const normalizeAssertString = str => {
+	return str.replace(/[\r\t]/gm, '').replace(/[\r\n]/gm, '').replace(/  +/g, ' ')
+}
 mockAdapter.mockImplementation(() => ({
 	get: jest
 		.fn()
@@ -54,6 +57,14 @@ describe('source:get command tests', () => {
 		);
 		expect(GetCommand.flags).toMatchInlineSnapshot(`
 		Object {
+		  "confirm": Object {
+		    "allowNo": false,
+		    "char": "c",
+		    "default": false,
+		    "description": "Auto confirm print action prompt. CLI will not check ask user to print source.",
+		    "parse": [Function],
+		    "type": "boolean",
+		  },
 		  "multiple": Object {
 		    "allowNo": false,
 		    "char": "m",
@@ -78,15 +89,13 @@ describe('source:get command tests', () => {
 	});
 	test('Check executing without parameters', async () => {
 		await GetCommand.run([]).catch(err => {
-			expect(err.message).toEqual(`The "aio api-mesh:source:get" command requires additional parameters` +
-				`\nUse "aio api-mesh:source:get --help" to see parameters information.`)
+			expect(normalizeAssertString(err.message)).toEqual(
+				normalizeAssertString(`Something went wrong with "get" command. Please try again later.` +
+					`Error: \nThe "aio api-mesh:source:get" command requires additional parameters` +
+					`Use "aio api-mesh:source:get --help" to see parameters information.`)
+			);
 		});
-	});
-	test('Check executing success with multiple, copied to clipboard and logged to console', async () => {
-		await GetCommand.run(['-m']);
-		expect(ncp.readSync()).toEqual(expectedResultForSuccessScenarios);
-		expect(logSpy.mock.calls.pop()[0]).toEqual(expectedResultForSuccessScenarios);
-	});
+	});	
 	test('Check executing success with provided name and version, copied to clipboard and logged to console', async () => {
 		await GetCommand.run(['-s=test-01@0.0.1', '-s=test-02@0.0.1']);
 		expect(ncp.readSync()).toEqual(expectedResultForSuccessScenarios);
@@ -100,11 +109,8 @@ describe('source:get command tests', () => {
 	test('Check executing failed due to requested source does not exist', async () => {
 		const name = 'test-99';
 		await GetCommand.run([`-s=${name}`]).catch(err => {
-			expect(err.message).toEqual(
-				chalk.red(
-					`The source with the name "${name}" doesn't exist.` +
-					`\nUse "aio api-mesh:source:discover" command to see avaliable sources.`,
-				),
+			expect(err.message).toContain(
+				chalk.red(`The source with the name "test-99" doesn't exist.`),
 			);
 		});
 	});
@@ -112,11 +118,8 @@ describe('source:get command tests', () => {
 		const name = 'test-01';
 		const version = '1.1.1';
 		await GetCommand.run([`-s=${name}@${version}`]).catch(err => {
-			expect(err.message).toEqual(
-				chalk.red(
-					`The version "${version}" for source name "${name}" doesn't exist.` +
-					`\nUse "aio api-mesh:source:discover" command to see avaliable source versions.`,
-				),
+			expect(err.message).toContain(
+				chalk.red(`The version \"1.1.1\" for source name \"test-01\" doesn't exist.`),
 			);
 		});
 	});

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

@@ -0,0 +1,153 @@
+/*
+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 {
+		  "confirm": Object {
+		    "allowNo": false,
+		    "char": "c",
+		    "default": false,
+		    "description": "Auto confirm override action prompt. CLI will not check ask user to override source.",
+		    "parse": [Function],
+		    "type": "boolean",
+		  },
+		  "ignoreCache": Object {
+		    "allowNo": false,
+		    "char": "i",
+		    "default": false,
+		    "description": "Ignore cache and force manual org -> project -> workspace selection",
+		    "parse": [Function],
+		    "type": "boolean",
+		  },
+		  "source": Object {
+		    "char": "s",
+		    "description": "Source name",
+		    "input": Array [],
+		    "multiple": true,
+		    "parse": [Function],
+		    "type": "option",
+		  },
+		  "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/discover.js

@@ -9,12 +9,12 @@ OF ANY KIND, either express or implied. See the License for the specific languag
 governing permissions and limitations under the License.
 */
 
-const { Command, CliUx } = require('@oclif/core');
-const { promptConfirm, initRequestId } = require('../../../helpers');
-const GetCommand = require('./get');
+const { Command, CliUx, Flags } = require('@oclif/core');
+const { promptConfirm, initRequestId, promptMultiselect, promptSelect } = require('../../../helpers');
 const SourceRegistryStorage = require('source-registry-storage-adapter');
 const config = require('@adobe/aio-lib-core-config');
 const logger = require('../../../classes/logger');
+const InstallCommand = require('./install');
 
 
 class DiscoverCommand extends Command {
@@ -23,6 +23,7 @@ class DiscoverCommand extends Command {
 			await initRequestId();
 
 			logger.info(`RequestId: ${global.requestId}`);
+			const { flags } = await this.parse(DiscoverCommand);
 			const srs = new SourceRegistryStorage(config.get('api-mesh.sourceRegistry.path'));
 			let list;
 			try {
@@ -33,10 +34,24 @@ class DiscoverCommand extends Command {
 			}
 
 			this.generateSourcesTable(list);
-			const needInstall = await promptConfirm(`Are you want to install sources?`);
+			let needInstall = false;
+
+			if (flags.confirm) {
+				needInstall = true;
+			} else {
+			    needInstall = await promptConfirm(`Do you want to install sources?`);
+			}
+
 			if (needInstall) {
-				GetCommand.run(['-m']);
+				const toInstall = await this.handleMultiple(list)
+				const params = [];
+				toInstall.forEach(source => {
+					params.push('-s');
+					params.push(source)
+				})
+				InstallCommand.run(params);
 			}
+			
 		} catch (error) {
 			logger.error(error);
 			this.error(`
@@ -46,6 +61,36 @@ class DiscoverCommand extends Command {
 		}
 	}
 
+	async handleMultiple(data) {
+		const result = [];
+		let selectedList = await promptMultiselect(
+			'Select sources to install',
+			Object.values(data).map(elem => ({ name: elem.name, value: elem })),
+		) || [];
+		
+		if (!selectedList.length) {			
+			while (!selectedList.length) {
+				selectedList = await promptMultiselect(
+					'Please choose at least one source',
+					Object.values(data).map(elem => ({ name: elem.name, value: elem })),
+				) || []
+			}
+		}
+
+		for (const selected of selectedList) {
+			if (selected.versions.length > 1) {
+				const version = await promptSelect(
+					`Please choose the version of "${selected.name}" source`,
+					selected.versions.map(v => ({ name: `v${v}`, value: `${selected.name}@${v}` })),
+				);
+				result.push(version);
+			} else {
+				result.push(`${selected.name}@${selected.latest}`);
+			}
+		}
+		return result;
+	}
+
 	async generateSourcesTable(data) {
 		const columns = {
 			name: {
@@ -65,6 +110,14 @@ class DiscoverCommand extends Command {
 	}
 }
 
+DiscoverCommand.flags = {
+	confirm: Flags.boolean({
+		char: 'c',
+		description:'Auto confirm install action prompt. CLI will not check ask user to install source.',
+		default: false,
+	}),
+};
+
 DiscoverCommand.description = 'Return the list of avaliable sources';
 
 module.exports = DiscoverCommand;

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

@@ -41,7 +41,7 @@ class GetCommand extends Command {
 			const { flags } = await this.parse(GetCommand);
 			if (!flags.source && !flags.multiple) {
 				this.error(
-					`The "aio api-mesh:source:get" command requires additional parameters` +
+					`\nThe "aio api-mesh:source:get" command requires additional parameters` +
 					`\nUse "aio api-mesh:source:get --help" to see parameters information.`,
 				);
 			}
@@ -77,16 +77,20 @@ class GetCommand extends Command {
 					'The sources are copied to the clipboard, please paste them to your API Mesh configuration',
 				),
 			);
-			const print = await promptConfirm(`Do you want to print Source configurations in console?`);
-			if (print) {
+			if (!flags.confirm) {
+				const print = await promptConfirm(`Do you want to print Source configurations in console?`);
+				if (print) {
+					this.log(sourceConfigsString);
+				}
+			} else {
 				this.log(sourceConfigsString);
-			}
+			}	
 		} catch (error) {
 			logger.error(error);
 			this.error(`
-				Something went wrong with "get" command. Please try again later. 
-				${error}
-			`);
+				\nSomething went wrong with "get" command. Please try again later.
+				\n${error}`
+			);
 		}
 	}
 
@@ -116,6 +120,11 @@ class GetCommand extends Command {
 }
 
 GetCommand.flags = {
+	confirm: Flags.boolean({
+		char: 'c',
+		description:'Auto confirm print action prompt. CLI will not check ask user to print source.',
+		default: false,
+	}),
 	source: Flags.string({
 		char: 's',
 		description: 'Source name',
@@ -130,8 +139,8 @@ GetCommand.flags = {
 
 GetCommand.description = 'Command returns the content of a specific source.';
 GetCommand.examples = [
-	'$ aio api-mesh:source:get <version>@<source_name>',
-	'$ aio api-mesh:source:get <source_name>',
+	'$ aio api-mesh:source:get -s=<version>@<source_name>',
+	'$ aio api-mesh:source:get -s<source_name>',
 	'$ aio api-mesh:source:get -m',
 ];
 

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

@@ -0,0 +1,291 @@
+/*
+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 passedSourceVariables = this.getPassedSourceVariables(sourceVariables || [], variables);
+			const missedVariables = jsonInterpolate.getMissedVariables(passedSourceVariables, sourceVariables);
+			for (const missedVariable of missedVariables.map(item => item.name).filter((value, index, self) => self.indexOf(value) === index)) {
+				passedSourceVariables[missedVariable] = await promptInput(
+					`Enter the value for variable ${missedVariable}:`,
+				);
+			}
+
+			const { error, data } = jsonInterpolate.interpolate(
+				JSON.stringify(sourceConfig.provider),
+				passedSourceVariables,				
+			);
+			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 = flags.confirm ? true : 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;
+	}
+
+	getPassedSourceVariables(variablesInSource, passedVariables) {
+		const res = {}
+		variablesInSource.forEach(variable => {
+			if (passedVariables[variable.name]) {
+				res[variable.name] = passedVariables[variable.name]
+			}
+		});
+		return res;
+	}
+
+	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 = {
+	source: Flags.string({
+		char: 's',
+		description: 'Source name',
+		multiple: true,		
+	}),
+	confirm: Flags.boolean({
+		char: 'c',
+		description:'Auto confirm override action prompt. CLI will not check ask user to override source.',
+		default: false,
+	}),
+	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

@@ -434,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,

package/src/utils.js

@@ -49,8 +49,15 @@ const autoConfirmActionFlag = Flags.boolean({
 	default: false,
 });
 
+const jsonFlag = Flags.boolean({
+	description:
+		'Output JSON',
+	default: false,
+});
+
 module.exports = {
 	objToString,
 	ignoreCacheFlag,
 	autoConfirmActionFlag,
+	jsonFlag,
 };