@contentstack/apps-cli 1.0.0

package/lib/commands/app/create.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const tmp = tslib_1.__importStar(require("tmp"));
+const adm_zip_1 = tslib_1.__importDefault(require("adm-zip"));
+const pick_1 = tslib_1.__importDefault(require("lodash/pick"));
+const shell = tslib_1.__importStar(require("shelljs"));
+const merge_1 = tslib_1.__importDefault(require("lodash/merge"));
+const isEmpty_1 = tslib_1.__importDefault(require("lodash/isEmpty"));
+const path_1 = require("path");
+const fs_1 = require("fs");
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const base_command_1 = require("./base-command");
+const types_1 = require("../../types");
+const messages_1 = require("../../messages");
+const util_1 = require("../../util");
+class Create extends base_command_1.BaseCommand {
+    async run() {
+        this.sharedConfig.org = this.flags.org;
+        this.sharedConfig.appName = this.flags.name;
+        this.appData = require(this.sharedConfig.manifestPath);
+        await this.flagsPromptQueue();
+        this.appData.name = this.sharedConfig.appName;
+        this.appData.target_type = this.flags["app-type"];
+        if (this.flags["app-type"] === types_1.AppType.ORGANIZATION) {
+            this.appData.ui_location.locations = (0, util_1.getOrgAppUiLocation)();
+        }
+        try {
+            if (this.flags.yes ||
+                (await cli_utilities_1.cliux.inquire({
+                    type: "confirm",
+                    name: "cloneBoilerplate",
+                    message: this.messages.CONFIRM_CLONE_BOILERPLATE,
+                }))) {
+                await this.boilerplateFlow();
+            }
+            else {
+                await this.registerTheAppOnDeveloperHub(false);
+            }
+        }
+        catch (error) {
+            if ((error === null || error === void 0 ? void 0 : error.errorMessage) || (error === null || error === void 0 ? void 0 : error.message) || !(0, isEmpty_1.default)(error)) {
+                this.log((error === null || error === void 0 ? void 0 : error.errorMessage) || (error === null || error === void 0 ? void 0 : error.message) || error, "error");
+            }
+            this.exit(1);
+        }
+    }
+    /**
+     * @method boilerplateFlow
+     *
+     * @memberof Create
+     */
+    async boilerplateFlow() {
+        // NOTE Step 1: download the boilerplate app from GitHub
+        await this.unZipBoilerplate(await this.cloneBoilerplate());
+        tmp.setGracefulCleanup(); // NOTE If graceful cleanup is set, tmp will remove all controlled temporary objects on process exit
+        // NOTE Step 2: Registering the app
+        await this.registerTheAppOnDeveloperHub();
+        // NOTE Step 3: Install dependencies
+        cli_utilities_1.ux.action.start(this.messages.INSTALL_DEPENDENCIES);
+        await this.installDependencies();
+        cli_utilities_1.ux.action.stop();
+        this.log(this.$t(this.messages.START_APP_COMMAND, {
+            command: `cd ${this.sharedConfig.folderPath} && npm run start`,
+        }), "info");
+    }
+    /**
+     * @method promptQueue
+     *
+     * @memberof Create
+     */
+    async flagsPromptQueue() {
+        if ((0, isEmpty_1.default)(this.sharedConfig.appName)) {
+            this.sharedConfig.appName = await (0, util_1.getAppName)(this.sharedConfig.defaultAppName);
+        }
+        this.sharedConfig.org = await (0, util_1.getOrg)(this.flags, {
+            log: this.log,
+            managementSdk: this.managementSdk,
+        });
+    }
+    /**
+     * @method cloneBoilerplate
+     *
+     * @return {*}  {Promise<string>}
+     * @memberof Create
+     */
+    async cloneBoilerplate() {
+        cli_utilities_1.ux.action.start(this.messages.CLONE_BOILERPLATE);
+        const tmpObj = tmp.fileSync();
+        const filePath = tmpObj.name;
+        const writer = (0, fs_1.createWriteStream)(filePath);
+        const response = await new cli_utilities_1.HttpClient({ responseType: "stream" }).get(this.sharedConfig.appBoilerplateGithubUrl);
+        response === null || response === void 0 ? void 0 : response.data.pipe(writer);
+        return new Promise((resolve, reject) => {
+            writer
+                .on("finish", function () {
+                resolve(filePath);
+                cli_utilities_1.ux.action.stop();
+            })
+                .on("error", () => {
+                reject(this.messages.FILE_GENERATION_FAILURE);
+            });
+        });
+    }
+    /**
+     * @method unZipBoilerplate
+     *
+     * @param {string} filepath
+     * @memberof Create
+     */
+    async unZipBoilerplate(filepath) {
+        var _a;
+        const zip = new adm_zip_1.default(filepath);
+        const dataDir = (_a = this.flags["data-dir"]) !== null && _a !== void 0 ? _a : process.cwd();
+        let targetPath = (0, path_1.resolve)(dataDir, this.sharedConfig.appName);
+        const sourcePath = (0, path_1.resolve)(dataDir, this.sharedConfig.boilerplateName);
+        if (this.flags["data-dir"] && !(0, fs_1.existsSync)(this.flags["data-dir"])) {
+            (0, fs_1.mkdirSync)(this.flags["data-dir"], { recursive: true });
+        }
+        if ((0, fs_1.existsSync)(targetPath)) {
+            this.log(this.messages.DIR_EXIST, "warn");
+            targetPath = await (0, util_1.getDirName)(targetPath);
+        }
+        this.sharedConfig.folderPath = targetPath;
+        await new Promise((resolve, reject) => {
+            cli_utilities_1.ux.action.start(this.messages.UNZIP);
+            zip.extractAllToAsync(dataDir, true, false, (error) => {
+                cli_utilities_1.ux.action.stop();
+                if (!error) {
+                    (0, fs_1.renameSync)(sourcePath, targetPath);
+                    // NOTE write manifest into Boilerplate location
+                    return resolve();
+                }
+                reject(error);
+            });
+        });
+    }
+    /**
+     * @method registerTheAppOnDeveloperHub
+     *
+     * @param {boolean} [saveManifest=true]
+     * @memberof Create
+     */
+    async registerTheAppOnDeveloperHub(saveManifest = true, retry = 0) {
+        cli_utilities_1.ux.action.start(this.$t(this.messages.REGISTER_THE_APP_ON_DEVELOPER_HUB, {
+            appName: this.sharedConfig.appName,
+        }));
+        await this.managementAppSdk
+            .organization(this.sharedConfig.org)
+            .app()
+            .create(this.appData)
+            .then((response) => {
+            cli_utilities_1.ux.action.stop();
+            if (this.sharedConfig.nameChanged) {
+                (0, fs_1.renameSync)(this.sharedConfig.oldFolderPath, this.sharedConfig.folderPath);
+            }
+            const validKeys = [
+                "uid",
+                "name",
+                "icon",
+                "oauth",
+                "version",
+                "visibility",
+                "created_by",
+                "created_at",
+                "updated_by",
+                "updated_at",
+                "target_type",
+                "description",
+                "ui_location",
+                "organization_uid",
+                "framework_version",
+            ];
+            this.appData = (0, merge_1.default)(this.appData, (0, pick_1.default)(response, validKeys));
+            if (saveManifest) {
+                (0, fs_1.writeFileSync)((0, path_1.resolve)(this.sharedConfig.folderPath, "manifest.json"), JSON.stringify(this.appData), {
+                    encoding: "utf8",
+                    flag: "w",
+                });
+            }
+            this.log(this.messages.APP_CREATION_SUCCESS, "info");
+        })
+            .catch(async (error) => {
+            cli_utilities_1.ux.action.stop("Failed");
+            switch (error.status) {
+                case 400:
+                    this.log(this.messages.APP_CREATION_CONSTRAINT_FAILURE, "error");
+                    break;
+                case 403:
+                    this.log(this.messages.APP_INVALID_ORG, "error");
+                    break;
+                case 409:
+                    this.log(this.$t(this.messages.DUPLICATE_APP_NAME, {
+                        appName: this.appData.name,
+                    }), "warn");
+                    return await this.manageNameConflict(saveManifest, retry);
+                default:
+                    this.log(this.$t(this.messages.APP_CREATION_FAILURE, {
+                        appName: this.appData.name,
+                    }), "error");
+                    break;
+            }
+            this.rollbackBoilerplate();
+            if (error.errorMessage) {
+                this.log(error.errorMessage, "error");
+            }
+            throw error;
+        });
+    }
+    /**
+     * @method rollbackBoilerplate
+     *
+     * @memberof Create
+     */
+    rollbackBoilerplate() {
+        if ((0, fs_1.existsSync)(this.sharedConfig.folderPath)) {
+            cli_utilities_1.ux.action.start(this.messages.ROLLBACK_BOILERPLATE);
+            (0, fs_1.rmSync)(this.sharedConfig.folderPath, {
+                force: true,
+                recursive: true,
+                maxRetries: 3,
+            });
+            cli_utilities_1.ux.action.stop();
+        }
+    }
+    /**
+     * @method manageNameConflict
+     *
+     * @param {boolean} saveManifest
+     * @param {number} retry
+     * @return {*}  {Promise<void>}
+     * @memberof Create
+     */
+    async manageNameConflict(saveManifest, retry) {
+        this.sharedConfig.appName = await (0, util_1.getAppName)(`${this.sharedConfig.appName}+${retry + 1}`);
+        this.appData.name = this.sharedConfig.appName;
+        if (!this.sharedConfig.oldFolderPath) {
+            this.sharedConfig.oldFolderPath = this.sharedConfig.folderPath;
+        }
+        this.sharedConfig.folderPath = (0, path_1.resolve)((0, path_1.dirname)(this.sharedConfig.folderPath), this.appData.name);
+        this.sharedConfig.nameChanged = true;
+        return await this.registerTheAppOnDeveloperHub(saveManifest, retry);
+    }
+    /**
+     * @method installDependencies
+     *
+     * @memberof Create
+     */
+    async installDependencies() {
+        shell.cd(this.sharedConfig.folderPath);
+        await new Promise((resolve, reject) => {
+            shell.exec("npm install", { silent: true }, (error) => {
+                if (error !== 0) {
+                    return reject(error);
+                }
+                resolve();
+            });
+        });
+    }
+}
+Create.hidden = false;
+Create.description = "Create a new app in Developer Hub and optionally clone a boilerplate locally.";
+Create.examples = [
+    "$ <%= config.bin %> <%= command.id %>",
+    "$ <%= config.bin %> <%= command.id %> --name App-1 --app-type stack",
+    "$ <%= config.bin %> <%= command.id %> --name App-2 --app-type stack -d ./boilerplate",
+    "$ <%= config.bin %> <%= command.id %> --name App-3 --app-type organization --org <UID> -d ./boilerplate -c ./external-config.json",
+];
+Create.flags = {
+    name: cli_utilities_1.flags.string({
+        char: "n",
+        description: messages_1.appCreate.NAME_DESCRIPTION,
+    }),
+    "app-type": cli_utilities_1.flags.string({
+        default: "stack",
+        options: ["stack", "organization"],
+        description: messages_1.appCreate.APP_TYPE_DESCRIPTION,
+    }),
+    config: cli_utilities_1.flags.string({
+        char: "c",
+        description: messages_1.commonMsg.CONFIG,
+    }),
+    "data-dir": cli_utilities_1.flags.string({
+        char: "d",
+        description: messages_1.commonMsg.CURRENT_WORKING_DIR,
+    }),
+};
+exports.default = Create;

package/lib/commands/app/delete.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from "./base-command";
+export default class Delete extends BaseCommand<typeof Delete> {
+    static hidden: boolean;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        "app-uid": import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/app/delete.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_command_1 = require("./base-command");
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const messages_1 = require("../../messages");
+const util_1 = require("../../util");
+class Delete extends base_command_1.BaseCommand {
+    async run() {
+        try {
+            let app;
+            this.sharedConfig.org = await (0, util_1.getOrg)(this.flags, {
+                managementSdk: this.managementSdk,
+                log: this.log,
+            });
+            if (!this.flags["app-uid"]) {
+                app = await (0, util_1.getApp)(this.flags, this.sharedConfig.org, {
+                    managementSdk: this.managementAppSdk,
+                    log: this.log,
+                });
+                this.flags["app-uid"] = app === null || app === void 0 ? void 0 : app.uid;
+            }
+            const { items: appInstallations } = await (0, util_1.fetchAppInstallations)(this.flags, this.sharedConfig.org, { managementSdk: this.managementAppSdk, log: this.log });
+            if (appInstallations.length === 0) {
+                const userConfirmation = this.flags['yes'] || await cli_utilities_1.cliux.inquire({
+                    type: "confirm",
+                    message: messages_1.deleteAppMsg.DELETE_CONFIRMATION,
+                    name: "confirmation"
+                });
+                if (userConfirmation) {
+                    await (0, util_1.deleteApp)(this.flags, this.sharedConfig.org, {
+                        managementSdk: this.managementAppSdk,
+                        log: this.log,
+                    });
+                    this.log((0, messages_1.$t)(messages_1.deleteAppMsg.APP_DELETED_SUCCESSFULLY, {
+                        app: (app === null || app === void 0 ? void 0 : app.name) || this.flags["app-uid"],
+                    }), "info");
+                }
+                else {
+                    this.log(messages_1.commonMsg.USER_TERMINATION, "error");
+                }
+            }
+            else {
+                this.log(messages_1.deleteAppMsg.APP_IS_INSTALLED, "error");
+            }
+        }
+        catch (error) {
+            this.log((error === null || error === void 0 ? void 0 : error.errorMessage) || (error === null || error === void 0 ? void 0 : error.message) || error, "error");
+            if (error.status === 400) {
+                // check for invalid app-uid
+                this.log(messages_1.deleteAppMsg.PLEASE_SELECT_APP_FROM_LIST);
+                delete this.flags["app-uid"];
+                await this.run();
+            }
+            if (error.status === 409 && error.statusText === "Conflict") {
+                this.log(messages_1.commonMsg.CONTACT_SUPPORT, "error");
+            }
+        }
+    }
+}
+Delete.hidden = false;
+Delete.description = "Delete app from marketplace";
+Delete.examples = [
+    "$ <%= config.bin %> <%= command.id %>",
+    "$ <%= config.bin %> <%= command.id %> --app-uid <value>",
+    "$ <%= config.bin %> <%= command.id %> --app-uid <value> --org <value> -d ./boilerplate",
+];
+Delete.flags = {
+    "app-uid": cli_utilities_1.flags.string({
+        description: messages_1.commonMsg.APP_UID,
+    }),
+};
+exports.default = Delete;

package/lib/commands/app/get.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "./base-command";
+export default class Get extends BaseCommand<typeof Get> {
+    static hidden: boolean;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        "app-uid": import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        "app-type": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        "data-dir": import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/app/get.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_command_1 = require("./base-command");
+const util_1 = require("../../util");
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const messages_1 = require("../../messages");
+class Get extends base_command_1.BaseCommand {
+    async run() {
+        try {
+            let appData;
+            this.sharedConfig.org = await (0, util_1.getOrg)(this.flags, {
+                managementSdk: this.managementSdk,
+                log: this.log,
+            });
+            if (!this.flags["app-uid"]) {
+                appData = await (0, util_1.getApp)(this.flags, this.sharedConfig.org, {
+                    managementSdk: this.managementAppSdk,
+                    log: this.log,
+                });
+            }
+            else {
+                appData = await (0, util_1.fetchApp)(this.flags, this.sharedConfig.org, {
+                    managementSdk: this.managementAppSdk,
+                    log: this.log,
+                });
+            }
+            await (0, util_1.writeFile)(this.flags["data-dir"], this.flags["yes"], appData, this.log);
+        }
+        catch (error) {
+            this.log((error === null || error === void 0 ? void 0 : error.errorMessage) || (error === null || error === void 0 ? void 0 : error.message) || error, "error");
+            this.exit(1);
+        }
+    }
+}
+Get.hidden = false;
+Get.description = "Get details of an app in developer hub";
+Get.examples = [
+    "$ <%= config.bin %> <%= command.id %>",
+    "$ <%= config.bin %> <%= command.id %> --org <value> --app-uid <value>",
+    "$ <%= config.bin %> <%= command.id %> --org <value> --app-uid <value> --app-type stack",
+    "$ <%= config.bin %> <%= command.id %> --org <value> --app-uid <value> --app-type organization",
+];
+Get.flags = {
+    "app-uid": cli_utilities_1.flags.string({
+        description: messages_1.commonMsg.APP_UID,
+    }),
+    "app-type": cli_utilities_1.flags.string({
+        default: "stack",
+        options: ["stack", "organization"],
+        description: messages_1.commonMsg.APP_TYPE_DESCRIPTION,
+    }),
+    "data-dir": cli_utilities_1.flags.string({
+        char: "d",
+        description: messages_1.commonMsg.CURRENT_WORKING_DIR,
+    }),
+};
+exports.default = Get;

package/lib/commands/app/index.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "@contentstack/cli-utilities";
+export default class App extends Command {
+    static description: string;
+    static hidden: boolean;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/lib/commands/app/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const log_1 = require("../../util/log");
+class App extends cli_utilities_1.Command {
+    async run() {
+        (0, child_process_1.exec)(`${(0, path_1.resolve)(process.cwd(), "bin", "run")} app --help`, (_er, stdout, _stderr) => {
+            if (stdout) {
+                this.log(`\n${stdout}`);
+            }
+            else {
+                (0, log_1.print)([
+                    {
+                        bold: true,
+                        color: "yellow",
+                        message: `\nUse '${this.config.bin} app --help' command to see more info\n`,
+                    },
+                ]);
+            }
+        });
+    }
+}
+App.description = "Apps CLI plugin";
+App.hidden = true;
+App.examples = [
+    "$ <%= config.bin %> <%= command.id %>:create",
+    "$ <%= config.bin %> <%= command.id %>:get",
+    "$ <%= config.bin %> <%= command.id %>:update",
+    "$ <%= config.bin %> <%= command.id %>:delete",
+    "$ <%= config.bin %> <%= command.id %>:install",
+    "$ <%= config.bin %> <%= command.id %>:uninstall",
+];
+exports.default = App;

package/lib/commands/app/install.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from "./base-command";
+export default class Install extends BaseCommand<typeof Install> {
+    static description: string | undefined;
+    static hidden: boolean;
+    static examples: string[];
+    static flags: {
+        'app-uid': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'stack-api-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/app/install.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_command_1 = require("./base-command");
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const messages_1 = require("../../messages");
+const util_1 = require("../../util");
+class Install extends base_command_1.BaseCommand {
+    async run() {
+        try {
+            let app, stack, appType;
+            // validating user given stack, as installation API doesn't return appropriate errors if stack-api-key is invalid
+            // validating this first, as orgUid is not required for fetching stack
+            if (this.flags['stack-api-key']) {
+                stack = await (0, util_1.fetchStack)(this.flags, { managementSdk: this.managementSdk, log: this.log });
+            }
+            // get organization to be used
+            this.sharedConfig.org = await (0, util_1.getOrg)(this.flags, { managementSdk: this.managementSdk, log: this.log });
+            // fetch app details
+            if (!this.flags['app-uid']) {
+                app = await (0, util_1.getApp)(this.flags, this.sharedConfig.org, { managementSdk: this.managementAppSdk, log: this.log });
+            }
+            else {
+                app = await (0, util_1.fetchApp)(this.flags, this.sharedConfig.org, { managementSdk: this.managementAppSdk, log: this.log });
+            }
+            appType = app === null || app === void 0 ? void 0 : app['target_type']; // get app-type from the fetched app
+            this.flags['app-uid'] = app === null || app === void 0 ? void 0 : app.uid;
+            // in case stack-api-key is provided and the selected app is an organization app
+            if (appType === 'organization' && this.flags['stack-api-key']) {
+                const confirmation = this.flags['yes'] || await cli_utilities_1.cliux.inquire({
+                    type: "confirm",
+                    message: (0, messages_1.$t)(messages_1.installAppMsg.INSTALL_ORG_APP_TO_STACK, { app: (app === null || app === void 0 ? void 0 : app.name) || (app === null || app === void 0 ? void 0 : app.uid) }),
+                    name: "confirmation"
+                });
+                if (!confirmation) {
+                    throw new Error(messages_1.commonMsg.USER_TERMINATION);
+                }
+            }
+            // in case a stack app is selected and no stack-api-key is provided
+            if (appType === 'stack' && !this.flags['stack-api-key']) {
+                this.log((0, messages_1.$t)(messages_1.installAppMsg.MISSING_STACK_API_KEY, { app: (app === null || app === void 0 ? void 0 : app.name) || (app === null || app === void 0 ? void 0 : app.uid) }), "warn");
+                stack = await (0, util_1.getStack)(this.sharedConfig.org, { managementSdk: this.managementSdk, log: this.log });
+                this.flags['stack-api-key'] = stack === null || stack === void 0 ? void 0 : stack['api_key'];
+            }
+            // install app
+            this.log((0, messages_1.$t)(messages_1.installAppMsg.INSTALLING_APP_NOTICE, {
+                app: (app === null || app === void 0 ? void 0 : app.name) || (app === null || app === void 0 ? void 0 : app.uid),
+                type: appType,
+                target: this.flags['stack-api-key'] || this.sharedConfig.org
+            }), "info");
+            await (0, util_1.installApp)(this.flags, this.sharedConfig.org, appType, { managementSdk: this.managementAppSdk, log: this.log });
+            this.log((0, messages_1.$t)(messages_1.installAppMsg.APP_INSTALLED_SUCCESSFULLY, {
+                app: (app === null || app === void 0 ? void 0 : app.name) || this.flags['app-uid'],
+                target: (stack === null || stack === void 0 ? void 0 : stack.name) || this.sharedConfig.org
+            }), "info");
+        }
+        catch (error) {
+            this.log((error === null || error === void 0 ? void 0 : error.errorMessage) || (error === null || error === void 0 ? void 0 : error.message) || error, "error");
+            this.exit(1);
+        }
+    }
+}
+Install.description = "Install an app from the marketplace";
+Install.hidden = false;
+Install.examples = [
+    "$ <%= config.bin %> <%= command.id %>",
+    "$ <%= config.bin %> <%= command.id %> --org <UID> --app-uid <APP-UID-1>",
+    "$ <%= config.bin %> <%= command.id %> --org <UID> --app-uid <APP-UID-1> --stack-api-key <STACK-API-KEY-1>",
+];
+Install.flags = {
+    'app-uid': cli_utilities_1.flags.string({
+        description: messages_1.commonMsg.APP_UID,
+    }),
+    'stack-api-key': cli_utilities_1.flags.string({
+        description: messages_1.commonMsg.STACK_API_KEY
+    })
+};
+exports.default = Install;

package/lib/commands/app/uninstall.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from "./base-command";
+export default class Uninstall extends BaseCommand<typeof Uninstall> {
+    static description: string;
+    static hidden: boolean;
+    static examples: string[];
+    static flags: {
+        'app-uid': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'installation-uid': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/app/uninstall.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_command_1 = require("./base-command");
+const cli_utilities_1 = require("@contentstack/cli-utilities");
+const util_1 = require("../../util");
+const messages_1 = require("../../messages");
+class Uninstall extends base_command_1.BaseCommand {
+    async run() {
+        try {
+            let app, appType;
+            // get organization to be used
+            this.sharedConfig.org = await (0, util_1.getOrg)(this.flags, { managementSdk: this.managementSdk, log: this.log });
+            // fetch app details
+            if (!this.flags['app-uid']) {
+                app = await (0, util_1.getApp)(this.flags, this.sharedConfig.org, { managementSdk: this.managementAppSdk, log: this.log });
+            }
+            else {
+                app = await (0, util_1.fetchApp)(this.flags, this.sharedConfig.org, { managementSdk: this.managementAppSdk, log: this.log });
+            }
+            this.flags['app-uid'] = app === null || app === void 0 ? void 0 : app.uid;
+            appType = app === null || app === void 0 ? void 0 : app['target_type'];
+            // select installation uid to uninstall
+            if (!this.flags['installation-uid']) {
+                this.flags['installation-uid'] = await (0, util_1.getInstallation)(this.flags, this.sharedConfig.org, this.managementSdk, appType, { managementSdk: this.managementAppSdk, log: this.log });
+            }
+            // uninstall app
+            await (0, util_1.uninstallApp)(this.flags, this.sharedConfig.org, { managementSdk: this.managementAppSdk, log: this.log });
+            this.log(this.$t(messages_1.uninstallAppMsg.APP_UNINSTALLED, { app: (app === null || app === void 0 ? void 0 : app.name) || this.flags["app-uid"] }), "info");
+        }
+        catch (error) {
+            this.log((error === null || error === void 0 ? void 0 : error.errorMessage) || (error === null || error === void 0 ? void 0 : error.message) || error, "error");
+            this.exit(1);
+        }
+    }
+}
+Uninstall.description = "Uninstall an app";
+Uninstall.hidden = false;
+Uninstall.examples = [
+    "$ <%= config.bin %> <%= command.id %>",
+    "$ <%= config.bin %> <%= command.id %> --org <UID> --app-uid <APP-UID-1>",
+    "$ <%= config.bin %> <%= command.id %> --org <UID> --app-uid <APP-UID-1> --installation-uid <INSTALLATION-UID-1>",
+];
+Uninstall.flags = {
+    'app-uid': cli_utilities_1.flags.string({
+        description: messages_1.commonMsg.APP_UID,
+    }),
+    'installation-uid': cli_utilities_1.flags.string({
+        description: messages_1.uninstallAppMsg.INSTALLATION_UID
+    })
+};
+exports.default = Uninstall;