feat: added support for uninstall all flag

Author: Vikram Kalta

README.md

@@ -155,12 +155,13 @@ Uninstall an app
 
 ```
 USAGE
-  $ csdx app:uninstall [--org <value>] [--app-uid <value>] [--installation-uid <value>]
+  $ csdx app:uninstall [--org <value>] [--app-uid <value>] [--installation-uid <value>] [--uninstall-all]
 
 FLAGS
   --app-uid=<value>           Provide the app UID
   --installation-uid=<value>  Provide the installation ID of the app that needs to be uninstalled.
   --org=<value>               Provide the organization UID
+  --uninstall-all             Please select stacks from where the app must be uninstalled.
 
 DESCRIPTION
   Uninstall an app

src/commands/app/uninstall.ts

@@ -1,7 +1,8 @@
 import { BaseCommand } from "./base-command";
 import { flags } from "@contentstack/cli-utilities";
-import { getOrg, getApp, fetchApp, getInstallation, uninstallApp } from "../../util";
+import { getOrg, getApp, fetchApp } from "../../util";
 import { commonMsg, uninstallAppMsg } from "../../messages";
+import { UninstallAppFactory } from "../../factories/uninstall-app-factory";
 
 export default class Uninstall extends BaseCommand<typeof Uninstall> {
     static description = "Uninstall an app";
@@ -19,6 +20,9 @@ export default class Uninstall extends BaseCommand<typeof Uninstall> {
       }),
       'installation-uid': flags.string({
         description: uninstallAppMsg.INSTALLATION_UID
+      }),
+      'uninstall-all': flags.boolean({
+        description: uninstallAppMsg.UNINSTALL_ALL,
       })
     }
 
@@ -34,19 +38,14 @@ export default class Uninstall extends BaseCommand<typeof Uninstall> {
         } else {
           app = await fetchApp(this.flags, this.sharedConfig.org, {managementSdk: this.managementAppSdk, log: this.log})
         }
-        
+
         this.flags['app-uid'] = app?.uid;
         appType = app?.['target_type']
 
-        // select installation uid to uninstall
-        if (!this.flags['installation-uid']) {
-          this.flags['installation-uid'] = await getInstallation(this.flags, this.sharedConfig.org, this.managementSdk, appType, {managementSdk: this.managementAppSdk, log: this.log})
-        }
-        
-        // uninstall app
-        for (const installationUid of this.flags['installation-uid']) {
-          await uninstallApp(this.flags, this.sharedConfig.org, {managementSdk: this.managementAppSdk, log: this.log}, installationUid)
-        }
+        const factory = new UninstallAppFactory()
+        const strategy = factory.getStrategyInstance(this.flags['uninstall-all'])
+        await strategy.run(this.flags, this.sharedConfig.org, {managementSdk: this.managementAppSdk, log: this.log}, appType)
+
         this.log(this.$t(uninstallAppMsg.APP_UNINSTALLED, { app: app?.name || this.flags["app-uid"] }), "info")
 
       } catch (error: any) {

src/factories/uninstall-app-factory.ts

@@ -0,0 +1,15 @@
+import { UninstallApp } from "../interfaces/uninstall-app";
+import { UninstallAll } from "../strategies/uninstall-all";
+import { UninstallSelected } from "../strategies/uninstall-selected";
+
+export class UninstallAppFactory {
+  public getStrategyInstance(uninstallAll: boolean): UninstallApp {
+    let strategy: UninstallApp;
+    if (uninstallAll) {
+      strategy = new UninstallAll()
+    } else {
+      strategy = new UninstallSelected()
+    }
+    return strategy
+  }
+}

src/interfaces/uninstall-app.ts

@@ -0,0 +1,7 @@
+import { FlagInput } from "@contentstack/cli-utilities";
+import { CommonOptions } from "../util";
+import { AppTarget } from "@contentstack/management/types/app/index"
+
+export interface UninstallApp {
+  run(flags: FlagInput, org: string, options: CommonOptions, appType: AppTarget): Promise<void>;
+}

src/messages/index.ts

@@ -95,7 +95,8 @@ const uninstallAppMsg = {
   INSTALLATION_UID: "Provide the installation ID of the app that needs to be uninstalled.",
   NO_INSTALLATIONS_FOUND: "Cannot find any installations for this app.",
   APP_UNINSTALLED: "{app} uninstalled successfully.",
-  UNINSTALLING_APP: "Uninstalling app from {type}..."
+  UNINSTALLING_APP: "Uninstalling app from {type}...",
+  UNINSTALL_ALL: "Please select stacks from where the app must be uninstalled.",
 }
 
 const messages: typeof errors &

src/strategies/uninstall-all.ts

@@ -0,0 +1,19 @@
+import { FlagInput } from "@contentstack/cli-utilities";
+import { UninstallApp } from "../interfaces/uninstall-app";
+import { CommonOptions, getInstallation, uninstallApp } from "../util";
+import { AppTarget } from "@contentstack/management/types/app/index"
+
+export class UninstallAll implements UninstallApp {
+  public async run(flags: FlagInput, org: string, options: CommonOptions, appType: AppTarget): Promise<void> {
+    // get all installation uids to uninstall
+    const installationUids = await this.getInstallations(flags, org, options, appType)
+    for (const installationUid of installationUids) {
+      await uninstallApp(flags, org, options, installationUid)
+    }
+  }
+
+  public async getInstallations(flags: FlagInput, org: string, options: CommonOptions, appType: AppTarget): Promise<string[]> {
+    let installationUids: string = await getInstallation(flags, org, options.managementSdk, appType, options, true)
+    return installationUids.split(',')
+  }
+}

src/strategies/uninstall-selected.ts

@@ -0,0 +1,22 @@
+import { FlagInput } from "@contentstack/cli-utilities";
+import { UninstallApp } from "../interfaces/uninstall-app";
+import { CommonOptions, getInstallation, uninstallApp } from "../util";
+import { AppTarget } from "@contentstack/management/types/app/index"
+
+export class UninstallSelected implements UninstallApp {
+  public async run(flags: FlagInput, org: string, options: CommonOptions, appType: AppTarget): Promise<void> {
+    // select installation uid to uninstall
+    const installationUids = await this.getInstallations(flags, org, options, appType)
+    for (const installationUid of installationUids) {
+      await uninstallApp(flags, org, options, installationUid)
+    }
+  }
+
+  public async getInstallations(flags: FlagInput, org: string, options: CommonOptions, appType: AppTarget): Promise<string[]> {
+    let installationUids: any = flags['installation-uid'];
+    if (!installationUids) {
+      installationUids = await getInstallation(flags, org, options.managementSdk, appType, options)
+    }
+    return installationUids.split(',')
+  }
+}

src/util/inquirer.ts

@@ -180,7 +180,8 @@ async function getInstallation(
   orgUid: string, 
   managementSdkForStacks: ContentstackClient,
   appType: AppTarget,
-  options:CommonOptions
+  options:CommonOptions,
+  uninstallAll?: boolean,
 ) : Promise<string> {
   const {log} = options;
   if (appType === 'stack') {
@@ -201,24 +202,29 @@ async function getInstallation(
     cliux.loader("done");
     const stacks: Stack[] = await getStacks({managementSdk: managementSdkForStacks, log: options.log}, orgUid);
     installations = populateMissingDataInInstallations(installations, stacks)
-    selectedInstallation = await cliux
+    // To support uninstall all flag
+    if (uninstallAll) {
+      return installations.join(',')
+    }
+    let _selectedInstallation = await cliux
     .inquire({
       type: 'checkbox',
       name: 'appInstallation',
       choices: installations,
       message: messages.CHOOSE_AN_INSTALLATION
-    }) as string
+    }) as string[]
+    selectedInstallation = _selectedInstallation.join(',')
   } else {
     // as this is an organization app, and it is supposed to only be installed on the source organization
     // it will be uninstalled from the selected organization
-    selectedInstallation = installations.pop()?.uid || "";
+    selectedInstallation = installations.pop()?.uid || ""
   }
 
   log($t(uninstallAppMsg.UNINSTALLING_APP, {
     type: appType
   }), "info")
 
-  return selectedInstallation;
+  return selectedInstallation
 }
 
 function populateMissingDataInInstallations(installations: [Installation], stacks: Stack[]): [Installation] {