@adobe/aio-cli-plugin-api-mesh 1.0.4-beta → 1.1.0

package/README.md

@@ -52,7 +52,10 @@ If you want to have custom configuration instead, please follow the steps below:
 ```
 {
     "baseUrl": "<base_url>",
-    "apiKey": "<api_key>"
+    "apiKey": "<api_key>",
+    "sourceRegistry: {
+        "path": "<path_to_the_source_registry_storage>"
+    }
 }
 ```
 
@@ -76,3 +79,32 @@ aio api-mesh:delete
 All commands support `-i` or `--ignoreCache` flag that will force the CLI to ignore the cached Org, Project and Workspace details and prompt the user to select new options just for that action.
 
 Create, Update and Delete support `-c` or `--autoConfirmAction` flag that will not prompt the user for action confirmation mostly used for testing or scaffolding where user prompt can not be handled. This flag is only to be used in certain situations.
+
+# Sources Registry
+
+Source registry is a collection of predefined sources (API mesh source configurations) that are created to solve specific use cases. The source can be installed for customer-specific API mesh configuration. 
+
+To submit a new source, please follow the instructions provided in the [Source Registry](https://github.com/adobe/api-mesh-sources/) repository.
+
+
+## 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:get -m 
+aio api-mesh:source:discover
+```
+
+The "source:get" command accept multiple sources per one call.
+
+Example:
+```
+aio api-mesh:source:get -m <NAME_OF_THE_SOURCE>@<VERSION_OF_THE_SOURC><NAME_OF_THE_SECOND_SOURCE>@<VERSION_OF_THE_SOURC>
+<NAME_OF_THE_THIRD_SOURCE>@<VERSION_OF_THE_SOURC>
+```
+
+All commands support `-i` or `--ignoreCache` flag that will force the CLI to ignore the cached Org, Project and Workspace details and prompt the user to select new options just for that action.
+
+Create, Update and Delete support `-c` or `--autoConfirmAction` flag that will not prompt the user for action confirmation mostly used for testing or scaffolding where user prompt can not be handled. This flag is only to be used in certain situations.

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"1.0.4-beta","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"}]}}}
+{"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":[]}}}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@adobe/aio-cli-plugin-api-mesh",
-	"version": "1.0.4-beta",
+	"version": "1.1.0",
 	"publishConfig": {
 		"access": "public"
 	},
@@ -15,10 +15,13 @@
 		"@oclif/core": "^1.14.1",
 		"@oclif/errors": "^1.1.2",
 		"axios": "^0.23.0",
+		"chalk": "^4.1.0",
 		"dotenv": "^16.0.1",
 		"inquirer": "^8.2.4",
+		"node-clipboardy": "^1.0.3",
 		"pino": "^7.9.2",
 		"pino-pretty": "^7.6.0",
+		"source-registry-storage-adapter": "github:devx-services/source-registry-storage-adapter#main",
 		"uuid": "^8.3.2"
 	},
 	"devDependencies": {
@@ -28,7 +31,6 @@
 		"@oclif/plugin-help": "2.2.3",
 		"@trivago/prettier-plugin-sort-imports": "^3.1.1",
 		"acorn": "7.4.1",
-		"chalk": "4.1.2",
 		"eslint": "7.28.0",
 		"eslint-config-oclif": "^3.1.0",
 		"eslint-config-prettier": "^8.3.0",

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

@@ -0,0 +1,44 @@
+{
+	"name": "Test 01",
+	"version": "0.0.1",
+	"description": "Mock for valid connector",
+	"author": "VZ",
+	"provider": {
+		"name": "Commerce",
+		"handler": {
+			"graphql": {
+				"endpoint": "https://venia.magento.com/graphql/"
+			}
+		},
+		"transforms": [
+			{
+				"rename": {
+					"mode": "bare | wrap",
+					"renames": [
+						{
+							"from": {
+								"type": "Query",
+								"field": "compareList"
+							},
+							"to": {
+								"type": "Query",
+								"field": "productCompareList"
+							}
+						}
+					]
+				}
+			},
+			{
+				"filterSchema": {
+					"mode": "bare | wrap",
+					"filters": [
+						"Query.!category",
+						"Query.!customerOrders",
+						"Query.!urlResolver",
+						"Query.!wishlist"
+					]
+				}
+			}
+		]
+	}
+}

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

@@ -0,0 +1,44 @@
+{
+	"name": "Test 02",
+	"version": "0.0.1",
+	"description": "Mock for valid connector",
+	"author": "VZ",
+	"provider": {
+		"name": "Commerce",
+		"handler": {
+			"graphql": {
+				"endpoint": "https://venia.magento.com/graphql/"
+			}
+		},
+		"transforms": [
+			{
+				"rename": {
+					"mode": "bare | wrap",
+					"renames": [
+						{
+							"from": {
+								"type": "Query",
+								"field": "compareList"
+							},
+							"to": {
+								"type": "Query",
+								"field": "productCompareList"
+							}
+						}
+					]
+				}
+			},
+			{
+				"filterSchema": {
+					"mode": "bare | wrap",
+					"filters": [
+						"Query.!category",
+						"Query.!customerOrders",
+						"Query.!urlResolver",
+						"Query.!wishlist"
+					]
+				}
+			}
+		]
+	}
+}

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

@@ -0,0 +1,16 @@
+{
+	"test-01": {
+		"name": "test-01",
+		"description": "Mock for valid connector",
+		"author": "VZ",
+		"latest": "0.0.2",
+		"versions": ["0.0.1", "0.0.2"]
+	},
+	"test-02": {
+		"name": "test-02",
+		"description": "Mock for valid connector",
+		"author": "VZ",
+		"latest": "0.0.1",
+		"versions": ["0.0.1"]
+	}
+}

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

@@ -0,0 +1,58 @@
+/*
+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 mockAdapter = require('source-registry-storage-adapter');
+const { promptConfirm } = require('../../../../helpers');
+const GetCommand = require('../get');
+const { CliUx } = require('@oclif/core');
+const DiscoverCommand = require('../discover');
+jest.mock('source-registry-storage-adapter');
+jest.mock('../../../../helpers');
+jest.mock('../get');
+jest.mock('@oclif/core', () => ({
+	...jest.requireActual('@oclif/core'),
+	CliUx: {
+		Table: {
+			table: jest.fn().mockImplementation(data => data),
+		},
+	},
+}));
+
+mockAdapter.mockImplementation(() => ({
+	getList: jest.fn().mockImplementation(() => mockMetadataFixture),
+}));
+
+describe('source:discover command tests', () => {
+	test('Snapshot create command description', () => {
+		expect(DiscoverCommand.description).toMatchInlineSnapshot(
+			`"Return the list of avaliable sources"`,
+		);
+		expect(DiscoverCommand.aliases).toMatchInlineSnapshot(`Array []`);
+	});
+	test('Check table render is executed', async () => {
+		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');
+		promptConfirm.mockResolvedValue(true);
+		await DiscoverCommand.run([]);
+		expect(GetCommand.run).toHaveBeenCalledTimes(1);
+	});
+	test('Check that "source:get -m" command is not called', async () => {
+		GetCommand.run = jest.fn().mockImplementation(() => 'source:get -m');
+		promptConfirm.mockResolvedValue(false);
+		await DiscoverCommand.run([]);
+		expect(GetCommand.run).toHaveBeenCalledTimes(0);
+	});
+});

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

@@ -0,0 +1,123 @@
+/*
+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 mockAdapter = require('source-registry-storage-adapter');
+const chalk = require('chalk');
+const ncp = require('node-clipboardy');
+const { promptMultiselect, promptSelect, promptConfirm } = require('../../../../helpers');
+const mockSources = {
+	'0.0.1-test-01': mockSourceTest01v1Fixture,
+	'0.0.1-test-02': mockSourceTest02v1Fixture,
+};
+jest.mock('source-registry-storage-adapter');
+jest.mock('../../../../helpers');
+const GetCommand = require('../get');
+const logSpy = jest.spyOn(GetCommand.prototype, 'log');
+const expectedResultForSuccessScenarios = JSON.stringify(
+	[mockSourceTest01v1Fixture.provider, mockSourceTest02v1Fixture.provider],
+	null,
+	4,
+);
+mockAdapter.mockImplementation(() => ({
+	get: jest
+		.fn()
+		.mockResolvedValueOnce(mockSources[`0.0.1-test-01`])
+		.mockResolvedValueOnce(mockSources[`0.0.1-test-02`]),
+	getList: jest.fn().mockImplementation(() => mockMetadataFixture),
+}));
+promptMultiselect.mockResolvedValue(Object.values(mockMetadataFixture));
+promptConfirm.mockResolvedValue(true);
+promptSelect
+	.mockResolvedValueOnce(
+		`${mockMetadataFixture['test-01'].name}@${mockMetadataFixture['test-01'].latest}`,
+	)
+	.mockResolvedValueOnce(
+		`${mockMetadataFixture['test-02'].name}@${mockMetadataFixture['test-02'].latest}`,
+	);
+
+describe('source:get command tests', () => {
+	test('Snapshot create command description', () => {
+		expect(GetCommand.description).toMatchInlineSnapshot(
+			`"Command returns the content of a specific source."`,
+		);
+		expect(GetCommand.flags).toMatchInlineSnapshot(`
+		Object {
+		  "multiple": Object {
+		    "allowNo": false,
+		    "char": "m",
+		    "description": "Select multiple sources",
+		    "exclusive": Array [
+		      "name",
+		    ],
+		    "parse": [Function],
+		    "type": "boolean",
+		  },
+		  "source": Object {
+		    "char": "s",
+		    "description": "Source name",
+		    "input": Array [],
+		    "multiple": true,
+		    "parse": [Function],
+		    "type": "option",
+		  },
+		}
+	`);
+		expect(GetCommand.aliases).toMatchInlineSnapshot(`Array []`);
+	});
+	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.`)
+		});
+	});
+	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);
+		expect(logSpy.mock.calls.pop()[0]).toEqual(expectedResultForSuccessScenarios);
+	});
+	test('Check executing success with provided name and without version, copied to clipboard and logged to console', async () => {
+		await GetCommand.run(['-s=test-01', '-s=test-02']);
+		expect(ncp.readSync()).toEqual(expectedResultForSuccessScenarios);
+		expect(logSpy.mock.calls.pop()[0]).toEqual(expectedResultForSuccessScenarios);
+	});
+	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.`,
+				),
+			);
+		});
+	});
+	test('Check executing failed due to requested version does not exist', async () => {
+		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.`,
+				),
+			);
+		});
+	});
+});

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

@@ -0,0 +1,70 @@
+/*
+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 { Command, CliUx } = require('@oclif/core');
+const { promptConfirm, initRequestId } = require('../../../helpers');
+const GetCommand = require('./get');
+const SourceRegistryStorage = require('source-registry-storage-adapter');
+const config = require('@adobe/aio-lib-core-config');
+const logger = require('../../../classes/logger');
+
+
+class DiscoverCommand extends Command {
+	async run() {
+		try {
+			await initRequestId();
+
+			logger.info(`RequestId: ${global.requestId}`);
+			const srs = new SourceRegistryStorage(config.get('api-mesh.sourceRegistry.path'));
+			let list;
+			try {
+				list = await srs.getList();
+			} catch (error) {
+				logger.error(error);
+				this.error(`Cannot get the list of sources: ${error}`);
+			}
+
+			this.generateSourcesTable(list);
+			const needInstall = await promptConfirm(`Are you want to install sources?`);
+			if (needInstall) {
+				GetCommand.run(['-m']);
+			}
+		} catch (error) {
+			logger.error(error);
+			this.error(`
+				Something went wrong with "discover" command. Please try again later. 
+				${error}
+			`);
+		}
+	}
+
+	async generateSourcesTable(data) {
+		const columns = {
+			name: {
+				get: row => `${row.name}`,
+			},
+			current: {
+				get: row => `${row.latest}`,
+			},
+			description: {
+				get: row => `${row.description}`,
+			},
+			versions: {
+				get: row => row.versions.reduce((prev, next) => `${prev}, ${next}`),
+			},
+		};
+		CliUx.Table.table(Object.values(data), columns);
+	}
+}
+
+DiscoverCommand.description = 'Return the list of avaliable sources';
+
+module.exports = DiscoverCommand;

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

@@ -0,0 +1,138 @@
+/*
+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 { promptMultiselect, promptSelect, promptConfirm, initRequestId } = require('../../../helpers');
+const ncp = require('node-clipboardy');
+const chalk = require('chalk');
+const config = require('@adobe/aio-lib-core-config');
+const logger = require('../../../classes/logger');
+
+class GetCommand extends Command {
+	constructor() {
+		super(...arguments);
+		this.sourceRegistryStorage = new SourceRegistryStorage(
+			config.get('api-mesh.sourceRegistry.path'),
+		);
+	}
+
+	async run() {
+		try {
+			await initRequestId();
+
+			logger.info(`RequestId: ${global.requestId}`);
+			let list
+			try {
+				list = await this.sourceRegistryStorage.getList();
+			} catch (err) {
+				this.log(err)
+				this.error(`Cannot get the list of sources: ${err}`)
+			}
+			const { flags } = await this.parse(GetCommand);
+			if (!flags.source && !flags.multiple) {
+				this.error(
+					`The "aio api-mesh:source:get" command requires additional parameters` +
+					`\nUse "aio api-mesh:source:get --help" to see parameters information.`,
+				);
+			}
+			const sources = flags.multiple ? await this.handleMultiple(list) : flags.source;
+			const sourceConfigs = [];
+			for (const source of sources) {
+				let [name, version] = source.split('@');
+				const normalizedName = this.normalizeName(name);
+				if (!list[normalizedName]) {
+					this.error(
+						chalk.red(
+							`The source with the name "${name}" doesn't exist.` +
+							`\nUse "aio api-mesh:source:discover" command to see avaliable sources.`,
+						),
+					);
+				}
+				version = version || list[normalizedName].latest;
+				if (!list[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);
+				sourceConfigs.push(sourceConfig.provider);
+			}
+			const sourceConfigsString = JSON.stringify(sourceConfigs, null, 4);
+			await ncp.writeSync(sourceConfigsString);
+			this.log(
+				chalk.green.bold.underline(
+					'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) {
+				this.log(sourceConfigsString);
+			}
+		} catch (error) {
+			logger.error(error);
+			this.error(`
+				Something went wrong with "get" command. Please try again later. 
+				${error}
+			`);
+		}
+	}
+
+	async handleMultiple(data) {
+		const result = [];
+		const selectedList = await promptMultiselect(
+			'Select sources to install',
+			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;
+	}
+
+	normalizeName(name) {
+		return name.toLowerCase().split(' ').join('-');
+	}
+}
+
+GetCommand.flags = {
+	source: Flags.string({
+		char: 's',
+		description: 'Source name',
+		multiple: true,
+	}),
+	multiple: Flags.boolean({
+		char: 'm',
+		description: 'Select multiple sources',
+		exclusive: ['name'],
+	}),
+};
+
+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 -m',
+];
+
+module.exports = GetCommand;

package/src/helpers.js

@@ -100,7 +100,6 @@ async function getAuthorizedOrganization() {
 			// remove selected project and workspace from config and let the user select a new one
 			Config.delete('console.project');
 			Config.delete('console.workspace');
-
 			return Object.assign({}, selectedOrg);
 		} else {
 			logger.error(`No organizations found`);
@@ -113,6 +112,10 @@ async function getAuthorizedOrganization() {
 	}
 }
 
+/**
+ * @param imsOrgId
+ * @param imsOrgTitle
+ */
 async function getProject(imsOrgId, imsOrgTitle) {
 	logger.info(`Initializing project selection for ${imsOrgId}`);
 
@@ -153,6 +156,12 @@ async function getProject(imsOrgId, imsOrgTitle) {
 	}
 }
 
+/**
+ * @param orgId
+ * @param projectId
+ * @param imsOrgTitle
+ * @param projectTitle
+ */
 async function getWorkspace(orgId, projectId, imsOrgTitle, projectTitle) {
 	logger.info(`Initializing workspace selection for ${orgId} -> ${projectId}`);
 
@@ -331,10 +340,52 @@ async function promptConfirm(message) {
 	return confirm.res;
 }
 
+/**
+ * Function to run the CLI selectable list
+ *
+ * @param {string} message - prompt message
+ * @param {object[]} choices - list of options
+ * @returns {object[]} - selected options
+ */
+async function promptMultiselect(message, choices) {
+	const selected = await inquirer.prompt([
+		{
+			name: 'items',
+			message: message,
+			type: 'checkbox',
+			choices: choices,
+		},
+	]);
+
+	return selected.items;
+}
+
+/**
+ * Function to run the CLI selectable list
+ *
+ * @param {string} message - prompt message
+ * @param {object[]} choices - list of options
+ * @returns {object[]} - selected options
+ */
+async function promptSelect(message, choices) {
+	const selected = await inquirer.prompt([
+		{
+			name: 'item',
+			message: message,
+			type: 'list',
+			choices: choices,
+		},
+	]);
+
+	return selected.item;
+}
+
 module.exports = {
 	promptConfirm,
 	getLibConsoleCLI,
 	getDevConsoleConfig,
 	initSdk,
 	initRequestId,
+	promptSelect,
+	promptMultiselect,
 };