Enhances command spo list remove

docs/docs/cmd/spo/list/list-remove.mdx

@@ -9,7 +9,7 @@ Removes the specified list
 ```sh
 m365 spo list remove [options]
 ```
-
+ 
 ## Options
 
 ```md definition-list
@@ -22,6 +22,9 @@ m365 spo list remove [options]
 `-t, --title [title]`
 : Title of the list to remove. Specify either `id` or `title` but not both.
 
+`--recycle`
+: Recycle the list
+
 `-f, --force`
 : Don't prompt for confirming removing the list.
 ```
@@ -42,6 +45,12 @@ Remove the list with a specific title located in a specific site.
 m365 spo list remove --webUrl https://contoso.sharepoint.com/sites/project-x --title 'List 1'
 ```
 
+Remove the list with a specific ID located in a specific site and send it to recycle bin
+
+```sh
+m365 spo list remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 0cd891ef-afce-4e55-b836-fce03286cccf --recycle
+```
+
 ## Response
 
 The command won't return a response on success.

src/m365/spo/commands/list/list-remove.spec.ts

@@ -147,6 +147,55 @@ describe(commands.LIST_REMOVE, () => {
     assert(correctRequestIssued);
   });
 
+  it('recycles the list when prompt confirmed', async () => {
+    sinon.stub(request, 'post').callsFake((opts) => {
+      requests.push(opts);
+
+      if ((opts.url as string).indexOf(`/recycle()`) > -1) {
+        if (opts.headers &&
+          opts.headers.accept &&
+          (opts.headers.accept as string).indexOf('application/json') === 0) {
+          return Promise.resolve();
+        }
+      }
+
+      return Promise.reject('Invalid request');
+    });
+
+    sinonUtil.restore(cli.promptForConfirmation);
+    sinon.stub(cli, 'promptForConfirmation').resolves(true);
+    await command.action(logger, { options: { id: 'b2307a39-e878-458b-bc90-03bc578531d6', webUrl: 'https://contoso.sharepoint.com', recycle: true } });
+    let correctRequestIssued = false;
+    requests.forEach(r => {
+      if (r.url.indexOf(`/recycle()`) > -1 &&
+        r.headers.accept &&
+        r.headers.accept.indexOf('application/json') === 0) {
+        correctRequestIssued = true;
+      }
+    });
+
+    assert(correctRequestIssued);
+  });
+
+  it('uses correct API url when recycle option is passed', async () => {
+    sinon.stub(request, 'post').callsFake((opts) => {
+      if ((opts.url as string).indexOf('/recycle()') > -1) {
+        return Promise.resolve('Correct Url');
+      }
+
+      return Promise.reject('Invalid request');
+    });
+
+    await command.action(logger, {
+      options: {
+        title: 'Documents',
+        recycle: true,
+        webUrl: 'https://contoso.sharepoint.com',
+        force: true
+      }
+    });
+  });
+
   it('command correctly handles list get reject request', async () => {
     const error = {
       error: {

src/m365/spo/commands/list/list-remove.ts

@@ -15,6 +15,7 @@ interface Options extends GlobalOptions {
   webUrl: string;
   id?: string;
   title?: string;
+  recycle?: boolean;
   force?: boolean;
 }
 
@@ -41,7 +42,8 @@ class SpoListRemoveCommand extends SpoCommand {
       Object.assign(this.telemetryProperties, {
         id: (!(!args.options.id)).toString(),
         title: (!(!args.options.title)).toString(),
-        force: (!(!args.options.force)).toString()
+        force: (!(!args.options.force)).toString(),
+        recycle: (!(!args.options.recycle)).toString()
       });
     });
   }
@@ -57,6 +59,9 @@ class SpoListRemoveCommand extends SpoCommand {
       {
         option: '-t, --title [title]'
       },
+      {
+        option: '--recycle'
+      },
       {
         option: '-f, --force'
       }
@@ -100,6 +105,10 @@ class SpoListRemoveCommand extends SpoCommand {
         requestUrl = `${args.options.webUrl}/_api/web/lists/GetByTitle('${formatting.encodeQueryParameter(args.options.title as string)}')`;
       }
 
+      if (args.options.recycle) {
+        requestUrl += `/recycle()`;
+      }
+
       const requestOptions: CliRequestOptions = {
         url: requestUrl,
         method: 'POST',