fix: add purgeondelete flag to deploy

command-snapshot.json

@@ -16,6 +16,7 @@
       "ignorewarnings",
       "json",
       "loglevel",
+      "purgeondelete",
       "runtests",
       "singlepackage",
       "soapdeploy",
@@ -143,6 +144,7 @@
       "metadata",
       "postdestructivechanges",
       "predestructivechanges",
+      "purgeondelete",
       "runtests",
       "soapdeploy",
       "sourcepath",

messages/deploy.json

@@ -29,7 +29,8 @@
     "validateDeployRequestId": "deploy request ID of the validated deployment to run a Quick Deploy",
     "soapDeploy": "deploy metadata with SOAP API instead of REST API",
     "predestructivechanges": "file path for a manifest (destructiveChangesPre.xml) of components to delete before the deploy",
-    "postdestructivechanges": "file path for a manifest (destructiveChangesPost.xml) of components to delete after the deploy"
+    "postdestructivechanges": "file path for a manifest (destructiveChangesPost.xml) of components to delete after the deploy",
+    "purgeOnDelete": "the deleted components in the destructiveChanges.xml manifest file aren't stored in the Recycle Bin. Instead, they become immediately eligible for deletion."
   },
   "flagsLong": {
     "sourcePath": [

messages/md.deploy.json

@@ -26,6 +26,7 @@
     "validatedDeployRequestId": "request ID of the validated deployment to run a Quick Deploy",
     "singlePackage": "Indicates that the zip file points to a directory structure for a single package",
     "soapDeploy": "deploy metadata with SOAP API instead of REST API",
+    "purgeOnDelete": "specify that deleted components in the destructive changes manifest file are immediately eligible for deletion rather than being stored in the Recycle Bin",
     "concise": "omit success messages for smaller JSON output"
   },
   "flagsLong": {

src/commands/force/mdapi/beta/deploy.ts

@@ -94,6 +94,9 @@ export class Deploy extends DeployCommand {
       description: messages.getMessage('flags.soapDeploy'),
       longDescription: messages.getMessage('flagsLong.soapDeploy'),
     }),
+    purgeondelete: flags.boolean({
+      description: messages.getMessage('flags.purgeOnDelete'),
+    }),
     concise: flags.builtin({
       description: messages.getMessage('flags.concise'),
     }),
@@ -123,6 +126,7 @@ export class Deploy extends DeployCommand {
       usernameOrConnection: this.org.getUsername(),
       ...deploymentOptions,
       apiOptions: {
+        purgeOnDelete: this.getFlag('purgeondelete', false),
         ignoreWarnings: this.getFlag('ignorewarnings', false),
         rollbackOnError: !this.getFlag('ignoreerrors', false),
         checkOnly: this.getFlag('checkonly', false),

src/commands/force/source/deploy.ts

@@ -70,6 +70,10 @@ export class Deploy extends DeployCommand {
       description: messages.getMessage('flags.ignoreWarnings'),
       longDescription: messages.getMessage('flagsLong.ignoreWarnings'),
     }),
+    purgeondelete: flags.boolean({
+      description: messages.getMessage('flags.purgeOnDelete'),
+      dependsOn: ['manifest'],
+    }),
     validateddeployrequestid: flags.id({
       char: 'q',
       description: messages.getMessage('flags.validateDeployRequestId'),
@@ -150,6 +154,7 @@ export class Deploy extends DeployCommand {
       const deploy = await this.componentSet.deploy({
         usernameOrConnection: this.org.getUsername(),
         apiOptions: {
+          purgeOnDelete: this.getFlag<boolean>('purgeondelete', false),
           ignoreWarnings: this.getFlag<boolean>('ignorewarnings', false),
           rollbackOnError: !this.getFlag<boolean>('ignoreerrors', false),
           checkOnly: this.getFlag<boolean>('checkonly', false),

test/commands/source/deploy.test.ts

@@ -156,9 +156,11 @@ describe('force:source:deploy', () => {
         ignoreWarnings: false,
         rollbackOnError: true,
         checkOnly: false,
+        purgeOnDelete: false,
         runTests: [],
         testLevel: 'NoTestRun',
         rest: false,
+        ...overrides?.apiOptions,
       },
     };
     if (overrides?.apiOptions) {
@@ -263,6 +265,87 @@ describe('force:source:deploy', () => {
     ensureProgressBar(0);
   });
 
+  it('should pass purgeOnDelete flag', async () => {
+    const manifest = 'package.xml';
+    const destructiveChanges = 'destructiveChangesPost.xml';
+    const runTests = ['MyClassTest'];
+    const testLevel = 'RunSpecifiedTests';
+    const result = await runDeployCmd([
+      `--manifest=${manifest}`,
+      `--postdestructivechanges=${destructiveChanges}`,
+      '--ignorewarnings',
+      '--ignoreerrors',
+      '--checkonly',
+      `--runtests=${runTests[0]}`,
+      `--testlevel=${testLevel}`,
+      '--purgeondelete',
+      '--json',
+    ]);
+
+    expect(result).to.deep.equal(expectedResults);
+    ensureDeployArgs({
+      apiOptions: {
+        checkOnly: true,
+        ignoreWarnings: true,
+        purgeOnDelete: true,
+        rest: false,
+        rollbackOnError: false,
+        runTests: ['MyClassTest'],
+        testLevel: 'RunSpecifiedTests',
+      },
+    });
+    ensureCreateComponentSetArgs({
+      manifest: {
+        manifestPath: manifest,
+        directoryPaths: [defaultDir],
+        destructiveChangesPost: destructiveChanges,
+        destructiveChangesPre: undefined,
+      },
+    });
+    ensureHookArgs();
+    ensureProgressBar(0);
+  });
+
+  it('should pass default purgeondelete flag to false', async () => {
+    const manifest = 'package.xml';
+    const destructiveChanges = 'destructiveChangesPost.xml';
+    const runTests = ['MyClassTest'];
+    const testLevel = 'RunSpecifiedTests';
+    const result = await runDeployCmd([
+      `--manifest=${manifest}`,
+      `--postdestructivechanges=${destructiveChanges}`,
+      '--ignorewarnings',
+      '--ignoreerrors',
+      '--checkonly',
+      `--runtests=${runTests[0]}`,
+      `--testlevel=${testLevel}`,
+      '--json',
+    ]);
+
+    expect(result).to.deep.equal(expectedResults);
+    ensureDeployArgs({
+      apiOptions: {
+        checkOnly: true,
+        ignoreWarnings: true,
+        purgeOnDelete: false,
+        rest: false,
+        rollbackOnError: false,
+        runTests: ['MyClassTest'],
+        testLevel: 'RunSpecifiedTests',
+      },
+    });
+    ensureCreateComponentSetArgs({
+      manifest: {
+        manifestPath: manifest,
+        directoryPaths: [defaultDir],
+        destructiveChangesPost: destructiveChanges,
+        destructiveChangesPre: undefined,
+      },
+    });
+    ensureHookArgs();
+    ensureProgressBar(0);
+  });
+
   it('should pass along all deploy options', async () => {
     const manifest = 'package.xml';
     const runTests = ['MyClassTest'];