Adds command 'teams callrecord list'. Closes #6737

Author: milanholemans

docs/docs/cmd/teams/callrecord/callrecord-list.mdx

@@ -0,0 +1,173 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams callrecord list
+
+Lists all Teams calls within the tenant
+
+## Usage
+
+```sh
+m365 teams callrecord list [options]
+```
+
+## Options
+
+```md definition-list
+`--userId [userId]`
+: Filters call records to only include those where the user participated. Use the Entra user ID of the user. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: Filters call records to only include those where the user participated. Use the UPN of the user. Specify either `userId` or `userName` but not both.
+
+`--startDateTime [startDateTime]`
+: Only show calls that started after this time. Defaults to 30 days ago.
+
+`--endDateTime [endDateTime]`
+: Only show calls that started before this time (exclusive). Defaults to now.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command only supports application permissions. Use scope `CallRecords.Read.All`.
+
+:::
+
+:::note
+
+It is only possible to retrieve call records from the past 30 days.
+
+:::
+
+## Examples
+
+Get all call records from the past 30 days.
+
+```sh
+m365 teams callrecord list
+```
+
+Get all call records where a specific user participated in.
+
+```sh
+m365 teams callrecord list --userName "john.doe@contoso.com"
+```
+
+Get all call records that started within a specific timeframe.
+
+```sh
+m365 teams callrecord list --startDateTime "2025-05-1T00:00:00Z" --endDateTime "2025-05-14T00:00:00Z"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "145ae53b-7781-47c4-a5f7-b0e043012624",
+      "version": 1,
+      "type": "peerToPeer",
+      "modalities": [
+        "audio"
+      ],
+      "lastModifiedDateTime": "2025-05-29T17:41:33.5066667Z",
+      "startDateTime": "2025-05-29T17:27:20.428943Z",
+      "endDateTime": "2025-05-29T17:37:20.428943Z",
+      "joinWebUrl": "",
+      "organizer": {
+        "acsUser": null,
+        "spoolUser": null,
+        "phone": null,
+        "guest": null,
+        "encrypted": null,
+        "onPremises": null,
+        "acsApplicationInstance": null,
+        "spoolApplicationInstance": null,
+        "applicationInstance": null,
+        "application": null,
+        "device": null,
+        "user": {
+          "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
+          "displayName": "John Doe",
+          "tenantId": "de5e90f2-9a07-4ed1-b903-f801afa7b1fd"
+        }
+      },
+      "participants": [],
+      "organizer_v2": {
+        "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
+        "identity": {
+          "endpointType": null,
+          "acsUser": null,
+          "spoolUser": null,
+          "phone": null,
+          "guest": null,
+          "encrypted": null,
+          "onPremises": null,
+          "acsApplicationInstance": null,
+          "spoolApplicationInstance": null,
+          "applicationInstance": null,
+          "application": null,
+          "device": null,
+          "azureCommunicationServicesUser": null,
+          "assertedIdentity": null,
+          "user": {
+            "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
+            "displayName": "John Doe",
+            "tenantId": "de5e90f2-9a07-4ed1-b903-f801afa7b1fd",
+            "userPrincipalName": "john.doe@contoso.com"
+          }
+        },
+        "administrativeUnitInfos": []
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    type        startDateTime                 endDateTime
+  ------------------------------------  ----------  ----------------------------  ----------------------------
+  145ae53b-7781-47c4-a5f7-b0e043012624  peerToPeer  2025-05-29T17:27:20.428943Z   2025-05-29T17:37:20.428943Z
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,version,type,lastModifiedDateTime,startDateTime,endDateTime,joinWebUrl
+  145ae53b-7781-47c4-a5f7-b0e043012624,1,peerToPeer,2025-05-29T17:41:33.5066667Z,2025-05-29T17:27:20.428943Z,2025-05-29T17:37:20.428943Z,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams callrecord list
+
+  Date: 03/06/2025
+
+  ## 145ae53b-7781-47c4-a5f7-b0e043012624
+
+  Property | Value
+  ---------|-------
+  id | 145ae53b-7781-47c4-a5f7-b0e043012624
+  version | 1
+  type | peerToPeer
+  lastModifiedDateTime | 2025-05-29T17:41:33.5066667Z
+  startDateTime | 2025-05-29T17:27:20.428943Z
+  endDateTime | 2025-05-29T17:37:20.428943Z
+  joinWebUrl |
+  ```
+
+  </TabItem>
+</Tabs>

docs/src/config/sidebars.ts

@@ -4317,6 +4317,15 @@ const sidebars: SidebarsConfig = {
             }
           ]
         },
+        {
+          callrecord: [
+            {
+              type: 'doc',
+              label: 'callrecord list',
+              id: 'cmd/teams/callrecord/callrecord-list'
+            }
+          ]
+        },
         {
           channel: [
             {

src/m365/base/GraphApplicationCommand.spec.ts

@@ -0,0 +1,56 @@
+import assert from 'assert';
+import sinon from 'sinon';
+import auth from '../../Auth.js';
+import { telemetry } from '../../telemetry.js';
+import GraphApplicationCommand from './GraphApplicationCommand.js';
+import { accessToken } from '../../utils/accessToken.js';
+import { CommandError } from '../../Command.js';
+
+class MockCommand extends GraphApplicationCommand {
+  public get name(): string {
+    return 'mock';
+  }
+
+  public get description(): string {
+    return 'Mock command';
+  }
+
+  public async commandAction(): Promise<void> {
+  }
+
+  public commandHelp(): void {
+  }
+}
+
+describe('GraphApplicationCommand', () => {
+  const cmd = new MockCommand();
+
+  before(() => {
+    sinon.stub(telemetry, 'trackEvent').resolves();
+    auth.connection.active = true;
+    auth.connection.accessTokens[auth.defaultResource] = {
+      expiresOn: 'abc',
+      accessToken: 'abc'
+    };
+  });
+
+  beforeEach(() => {
+    auth.connection.active = true;
+  });
+
+  after(() => {
+    sinon.restore();
+    auth.connection.active = false;
+    auth.connection.accessTokens = {};
+  });
+
+  it(`doesn't throw error when not connected`, async () => {
+    auth.connection.active = false;
+    await (cmd as any).initAction({ options: {} }, {});
+  });
+
+  it('throws error when using delegated permissions', async () => {
+    sinon.stub(accessToken, 'isAppOnlyAccessToken').returns(false);
+    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command requires application-only permissions.'));
+  });
+});

src/m365/base/GraphApplicationCommand.ts

@@ -0,0 +1,21 @@
+import auth from '../../Auth.js';
+import { CommandArgs } from '../../Command.js';
+import { Logger } from '../../cli/Logger.js';
+import { accessToken } from '../../utils/accessToken.js';
+import GraphCommand from './GraphCommand.js';
+
+/**
+ * This command class is for application-only Graph commands.  
+ */
+export default abstract class GraphApplicationCommand extends GraphCommand {
+  protected async initAction(args: CommandArgs, logger: Logger): Promise<void> {
+    await super.initAction(args, logger);
+
+    if (!auth.connection.active) {
+      // we fail no login in the base command command class
+      return;
+    }
+
+    accessToken.assertAccessTokenType('application');
+  }
+}

src/m365/base/DelegatedGraphCommand.spec.ts renamed to src/m365/base/GraphDelegatedCommand.spec.ts

@@ -2,11 +2,11 @@ import assert from 'assert';
 import sinon from 'sinon';
 import auth from '../../Auth.js';
 import { telemetry } from '../../telemetry.js';
-import DelegatedGraphCommand from './DelegatedGraphCommand.js';
+import GraphDelegatedCommand from './GraphDelegatedCommand.js';
 import { accessToken } from '../../utils/accessToken.js';
 import { CommandError } from '../../Command.js';
 
-class MockCommand extends DelegatedGraphCommand {
+class MockCommand extends GraphDelegatedCommand {
   public get name(): string {
     return 'mock';
   }
@@ -22,7 +22,7 @@ class MockCommand extends DelegatedGraphCommand {
   }
 }
 
-describe('DelegatedGraphCommand', () => {
+describe('GraphDelegatedCommand', () => {
   const cmd = new MockCommand();
 
   before(() => {
@@ -51,6 +51,6 @@ describe('DelegatedGraphCommand', () => {
 
   it('throws error when using application-only permissions', async () => {
     sinon.stub(accessToken, 'isAppOnlyAccessToken').returns(true);
-    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command does not support application-only permissions.'));
+    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command requires delegated permissions.'));
   });
 });

src/m365/base/DelegatedGraphCommand.ts renamed to src/m365/base/GraphDelegatedCommand.ts

@@ -5,9 +5,9 @@ import { accessToken } from '../../utils/accessToken.js';
 import GraphCommand from './GraphCommand.js';
 
 /**
- * This command class is for delegated-only Graph commands.  
+ * This command class is for delegated Graph commands.  
  */
-export default abstract class DelegatedGraphCommand extends GraphCommand {
+export default abstract class GraphDelegatedCommand extends GraphCommand {
   protected async initAction(args: CommandArgs, logger: Logger): Promise<void> {
     await super.initAction(args, logger);
 
@@ -16,6 +16,6 @@ export default abstract class DelegatedGraphCommand extends GraphCommand {
       return;
     }
 
-    accessToken.assertDelegatedAccessToken();
+    accessToken.assertAccessTokenType('delegated');
   }
 }

src/m365/base/PowerAppsCommand.spec.ts

@@ -90,6 +90,6 @@ describe('PowerAppsCommand', () => {
     sinonUtil.restore(accessToken.isAppOnlyAccessToken);
     sinon.stub(accessToken, 'isAppOnlyAccessToken').returns(true);
     auth.connection.cloudType = CloudType.Public;
-    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command does not support application-only permissions.'));
+    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command requires delegated permissions.'));
   });
 });

src/m365/base/PowerAppsCommand.ts

@@ -20,6 +20,6 @@ export default abstract class PowerAppsCommand extends Command {
       throw new CommandError(`Power Apps commands only support the public cloud at the moment. We'll add support for other clouds in the future. Sorry for the inconvenience.`);
     }
 
-    accessToken.assertDelegatedAccessToken();
+    accessToken.assertAccessTokenType('delegated');
   }
 }

src/m365/base/PowerAutomateCommand.spec.ts

@@ -89,6 +89,6 @@ describe('PowerAutomateCommand', () => {
     sinonUtil.restore(accessToken.isAppOnlyAccessToken);
     sinon.stub(accessToken, 'isAppOnlyAccessToken').returns(true);
     auth.connection.cloudType = CloudType.Public;
-    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command does not support application-only permissions.'));
+    await assert.rejects(() => (cmd as any).initAction({ options: {} }, {}), new CommandError('This command requires delegated permissions.'));
   });
 });

src/m365/base/PowerAutomateCommand.ts

@@ -20,6 +20,6 @@ export default abstract class PowerAutomateCommand extends Command {
       throw new CommandError(`Power Automate commands only support the public cloud at the moment. We'll add support for other clouds in the future. Sorry for the inconvenience.`);
     }
 
-    accessToken.assertDelegatedAccessToken();
+    accessToken.assertAccessTokenType('delegated');
   }
 }