@pnp/cli-microsoft365 11.1.0-beta.8311bbf → 11.1.0-beta.871ff4d

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-list.mdx

@@ -38,6 +38,24 @@ When operating in app-only mode, you have the option to use either the `userName
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of sensitivity labels.

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-policysettings-list.mdx

@@ -38,6 +38,24 @@ When operating in app-only mode, you have the option to use either the `userName
 
 :::
 
+## Permissions
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | InformationProtectionPolicy.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of policy settings for a sensitivity label.

package/docs/docs/cmd/purview/threatassessment/threatassessment-add.mdx

@@ -33,6 +33,18 @@ m365 purview threatassessment add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Remarks
 
 :::info

package/docs/docs/cmd/purview/threatassessment/threatassessment-get.mdx

@@ -24,6 +24,25 @@ m365 purview threatassessment get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.Read.All      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a threat assessment.

package/docs/docs/cmd/purview/threatassessment/threatassessment-list.mdx

@@ -21,6 +21,25 @@ m365 purview threatassessment list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                    |
+  |-----------------|--------------------------------|
+  | Microsoft Graph | ThreatAssessment.Read.All      |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a list of threat assessments

package/docs/docs/cmd/spo/web/web-alert-list.mdx

@@ -0,0 +1,187 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web alert list
+
+Lists all SharePoint list alerts
+
+## Usage
+
+```sh
+m365 spo web alert list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--listId [listId]`
+: The ID of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--listUrl [listUrl]`
+: The URL of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--listTitle [listTitle]`
+: The title of the SharePoint list. Specify either `listId`, `listUrl`, or `listTitle`, but not more than one.
+
+`--userName [userName]`
+: The user name to filter alerts for. Specify either `userName` or `userId`, but not both.
+
+`--userId [userId]`
+: The user ID to filter alerts for. Specify either `userName` or `userId`, but not both.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+List all alerts for a SharePoint site:
+
+```sh
+m365 spo web alert list --webUrl https://contoso.sharepoint.com/sites/Marketing
+```
+
+List alerts for a SharePoint list by listUrl:
+
+```sh
+m365 spo web alert list --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/Marketing/lists/Tasks
+```
+
+List alerts for a specific user by userId:
+
+```sh
+m365 spo web alert list --webUrl https://contoso.sharepoint.com/sites/Marketing --userId 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+List alerts for a specific list by title and user by username:
+
+```sh
+m365 spo web alert list --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle "Tasks" --userName jane.doe@contoso.com
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "AlertFrequency": 0,
+      "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
+      "AlertType": 1,
+      "AlwaysNotify": false,
+      "DeliveryChannels": 1,
+      "EventType": -1,
+      "Filter": "",
+      "ID": "c52b4bf0-add0-4323-b670-f765bb46337b",
+      "Properties": [
+        {
+          "Key": "dispformurl",
+          "Value": "Shared Documents/Forms/DispForm.aspx",
+          "ValueType": "Edm.String"
+        }
+      ],
+      "Status": 0,
+      "Title": "Documents: ProjectPlan.docx",
+      "UserId": 9,
+      "Item": {
+        "Id": 37326,
+        "FileRef": "/sites/marketing/Shared Documents/ProjectPlan.docx",
+        "GUID": "ef5cc60b-71c0-4357-a291-14274234efde"
+      },
+      "List": {
+        "Id": "6b4f195c-02da-47f4-8237-065b96258cf3",
+        "Title": "Documents",
+        "RootFolder": {
+          "ServerRelativeUrl": "/sites/marketing/Shared Documents"
+        }
+      },
+      "User": {
+        "Id": 9,
+        "IsHiddenInUI": false,
+        "LoginName": "i:0#.f|membership|jane.doe@contoso.onmicrosoft.com",
+        "Title": "Jane Doe",
+        "PrincipalType": 1,
+        "Email": "jane.doe@contoso.onmicrosoft.com",
+        "Expiration": "",
+        "IsEmailAuthenticationGuestUser": false,
+        "IsShareByEmailGuestUser": false,
+        "IsSiteAdmin": false,
+        "UserId": {
+          "NameId": "10037ffeaed549a5",
+          "NameIdIssuer": "urn:federation:microsoftonline"
+        },
+        "UserPrincipalName": "jane.doe@contoso.onmicrosoft.com"
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```txt
+  ID                                    Title                        UserPrincipalName
+  ------------------------------------  ---------------------------  --------------------
+  fa5115ee-0c72-4d17-9fda-ee2451ba1c6d  Documents: ProjectPlan.docx  jane.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  AlertFrequency,AlertTemplateName,AlertType,AlwaysNotify,DeliveryChannels,EventType,Filter,ID,Status,Title,UserId,UserPrincipalName
+  0,SPAlertTemplateType.DocumentLibrary,1,0,1,-1,,fa5115ee-0c72-4d17-9fda-ee2451ba1c6d,0,Documents: ProjectPlan.docx,6,jane.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo web alert list --webUrl "https://contoso.sharepoint.com/sites/marketing" --listUrl "/sites/marketing/Shared Documents"
+
+  Date: 10/6/2025
+
+  ## Documents: ProjectPlan.docx (c52b4bf0-add0-4323-b670-f765bb46337b)
+
+  Property | Value
+  ---------|-------
+  AlertFrequency | 0
+  AlertTemplateName | SPAlertTemplateType.DocumentLibrary
+  AlertType | 1
+  AlwaysNotify | false
+  DeliveryChannels | 1
+  EventType | -1
+  Filter |
+  ID | c52b4bf0-add0-4323-b670-f765bb46337b
+  Status | 0
+  Title | Documents: ProjectPlan.docx
+  UserId | 9
+  UserPrincipalName | jane.doe@contoso.com
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/web/web-alert-remove.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web alert remove
+
+Removes an alert from a SharePoint list
+
+## Usage
+
+```sh
+m365 spo web alert remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--id <id>`
+: The ID of the alert.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Remove an alert by ID
+
+```sh
+m365 spo web alert remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+Remove another alert without confirmation
+
+```sh
+m365 spo web alert remove --webUrl https://contoso.sharepoint.com/sites/Marketing --id 2b6f1c8a-3e6a-4c7e-b8c0-7bf4c8e6d7f1 --force
+```
+
+## Response
+
+The command won't return a response on success.

package/eslint-rules/lib/rules/correct-command-class-name.js

@@ -42,7 +42,7 @@ function capitalizeWord(word, capitalized) {
   return word.substr(0, 1).toUpperCase() + word.substr(1).toLowerCase();
 }
 
-function breakWords(longWord, dictionary) { 
+function breakWords(longWord, dictionary) {
   const words = [];
   for (let i = 0; i < dictionary.length; i++) {
     if (longWord.indexOf(dictionary[i]) === 0) {
@@ -72,7 +72,23 @@ module.exports = {
     fixable: 'code',
     messages: {
       invalidName: "'{{ actualClassName }}' is not a valid command class name. Expected '{{ expectedClassName }}'"
-    }
+    },
+    schema: [
+      {
+        type: 'array',
+        items: { type: 'string' },
+        uniqueItems: true,
+        title: 'dictionary',
+        description: 'List of known word parts used to break long command names into words.'
+      },
+      {
+        type: 'array',
+        items: { type: 'string' },
+        uniqueItems: true,
+        title: 'capitalized',
+        description: 'List of known word parts that should be capitalized.'
+      }
+    ]
   },
   create: context => {
     return {

package/eslint.config.mjs

@@ -0,0 +1,270 @@
+import globals from 'globals';
+import js from '@eslint/js';
+import parser from '@typescript-eslint/parser';
+import tsPlugin from '@typescript-eslint/eslint-plugin';
+import mocha from 'eslint-plugin-mocha';
+import stylistic from '@stylistic/eslint-plugin';
+import cliM365 from './eslint-rules/lib/index.js';
+
+// List of words used in command names used for word breaking
+// Sorted alphabetically for easy maintenance
+const dictionary = [
+  'access',
+  'activation',
+  'activations',
+  'adaptive',
+  'administrative',
+  'ai',
+  'app',
+  'application',
+  'apply',
+  'approve',
+  'assessment',
+  'assets',
+  'assignment',
+  'audit',
+  'azure',
+  'bin',
+  'builder',
+  'call',
+  'card',
+  'catalog',
+  'checklist',
+  'client',
+  'comm',
+  'command',
+  'community',
+  'container',
+  'content',
+  'conversation',
+  'custom',
+  'customizer',
+  'dataverse',
+  'default',
+  'definition',
+  'dev',
+  'details',
+  'directory',
+  'eligibility',
+  'enterprise',
+  'entra',
+  'event',
+  'eventreceiver',
+  'external',
+  'externalize',
+  'folder',
+  'fun',
+  'group',
+  'groupify',
+  'groupmembership',
+  'guest',
+  'health',
+  'hide',
+  'historical',
+  'home',
+  'hub',
+  'in',
+  'info',
+  'inheritance',
+  'init',
+  'install',
+  'installed',
+  'is',
+  'issue',
+  'item',
+  'label',
+  'list',
+  'link',
+  'log',
+  'login',
+  'logout',
+  'mailbox',
+  'management',
+  'member',
+  'membership',
+  'messaging',
+  'model',
+  'multitenant',
+  'm365',
+  'news',
+  'oauth2',
+  'office365',
+  'one',
+  'open',
+  'ops',
+  'org',
+  'organization',
+  'owner',
+  'permission',
+  'pim',
+  'place',
+  'policy',
+  'profile',
+  'pronouns',
+  'property',
+  'record',
+  'records',
+  'recycle',
+  'registration',
+  'request',
+  'resolver',
+  'retention',
+  'revoke',
+  'role',
+  'room',
+  'schema',
+  'search',
+  'sensitivity',
+  'service',
+  'session',
+  'set',
+  'setting',
+  'settings',
+  'setup',
+  'sharing',
+  'side',
+  'site',
+  'status',
+  'storage',
+  'table',
+  'teams',
+  'threat',
+  'to',
+  'todo',
+  'token',
+  'type',
+  'unit',
+  'url',
+  'user',
+  'value',
+  'web',
+  'webhook'
+];
+
+// List of words that should be capitalized in a specific way
+const capitalized = [
+  'OAuth2'
+];
+
+// Sort dictionary to put the longest words first
+const sortedDictionary = dictionary.sort((a, b) => b.length - a.length);
+
+export default [
+  // Ignored files
+  {
+    ignores: [
+      "**/package-generate/assets/**",
+      "**/test-projects/**",
+      "clientsidepages.ts",
+      "**/*.d.ts",
+      "**/*.js",
+      "**/*.cjs"
+    ]
+  },
+  // JS recommendations
+  js.configs.recommended,
+  {
+    plugins: { '@typescript-eslint': tsPlugin },
+    rules: tsPlugin.configs.recommended.rules
+  },
+  {
+    languageOptions: {
+      ecmaVersion: 2015,
+      sourceType: 'module',
+      parser: parser,
+      parserOptions: {
+        ecmaVersion: 2015,
+        sourceType: 'module',
+        project: './tsconfig.json'
+      },
+      globals: {
+        ...globals.node,
+        ...globals.commonjs,
+        ...globals.es2021,
+        ...globals.mocha,
+        NodeJS: 'readonly'
+      }
+    },
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+      'cli-microsoft365': cliM365,
+      '@stylistic': stylistic,
+      mocha
+    },
+    rules: {
+      'cli-microsoft365/correct-command-class-name': ['error', sortedDictionary, capitalized],
+      'cli-microsoft365/correct-command-name': 'error',
+      'cli-microsoft365/no-by-server-relative-url-usage': 'error',
+      '@stylistic/indent': ['error', 2],
+      '@stylistic/semi': ['error'],
+      '@stylistic/comma-dangle': ['error', 'never'],
+      '@stylistic/brace-style': [
+        'error',
+        'stroustrup',
+        { allowSingleLine: true }
+      ],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+      '@typescript-eslint/no-inferrable-types': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': [
+        'error',
+        { allowArgumentsExplicitlyTypedAsAny: true }
+      ],
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_' }
+      ],
+      camelcase: ['error', {
+        allow: [
+          'child_process',
+          'error_description',
+          '_Child_Items_',
+          '_Object_Type_',
+          'FN\\d+',
+          'OData__.*',
+          'vti_.*',
+          'Query.*',
+          'app_displayname',
+          'access_token',
+          'expires_on',
+          'extension_*'
+        ]
+      }],
+      curly: ['error', 'all'],
+      eqeqeq: ['error', 'always'],
+      '@typescript-eslint/naming-convention': [
+        'error',
+        {
+          selector: ['method'],
+          format: ['camelCase']
+        }
+      ],
+      '@typescript-eslint/explicit-function-return-type': ['error', { allowExpressions: true }],
+      'mocha/no-identical-title': 'error',
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-empty-function': 'error'
+    }
+  },
+  {
+    files: ['**/*.spec.ts'],
+    rules: {
+      'no-console': 'error',
+      '@typescript-eslint/no-empty-function': 'off',
+      'cli-microsoft365/correct-command-class-name': 'off',
+      'cli-microsoft365/correct-command-name': 'off'
+    }
+  },
+  {
+    files: ['**/viva/commands/engage/**'],
+    rules: {
+      camelcase: 'off'
+    }
+  },
+  {
+    files: ['**/*.mjs'],
+    rules: {
+      '@typescript-eslint/explicit-function-return-type': 'off'
+    }
+  }
+];