@pnp/cli-microsoft365 5.3.0-beta.ebb13d0 → 5.4.0-beta.694dbc5

package/dist/m365/search/commands/externalconnection/externalconnection-list.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const utils_1 = require("../../../../utils");
+const commands_1 = require("../../commands");
+class SearchExternalConnectionListCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.EXTERNALCONNECTION_LIST;
+    }
+    get description() {
+        return 'Lists external connections defined in the Microsoft Search';
+    }
+    defaultProperties() {
+        return ['id', 'name', 'state'];
+    }
+    commandAction(logger, args, cb) {
+        utils_1.odata
+            .getAllItems(`${this.resource}/v1.0/external/connections`)
+            .then((connections) => {
+            logger.log(connections);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+}
+module.exports = new SearchExternalConnectionListCommand();
+//# sourceMappingURL=externalconnection-list.js.map

package/dist/m365/search/commands.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const prefix = 'search';
 exports.default = {
-    EXTERNALCONNECTION_ADD: `${prefix} externalconnection add`
+    EXTERNALCONNECTION_ADD: `${prefix} externalconnection add`,
+    EXTERNALCONNECTION_LIST: `${prefix} externalconnection list`
 };
 //# sourceMappingURL=commands.js.map

package/dist/m365/spo/commands/eventreceiver/eventreceiver-get.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const utils_1 = require("../../../../utils");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoEventreceiverGetCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.EVENTRECEIVER_GET;
+    }
+    get description() {
+        return 'Gets a specific event receiver attached to the web, site or list (if any of the list options are filled in) by receiver name of id';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.listId = typeof args.options.listId !== 'undefined';
+        telemetryProps.listTitle = typeof args.options.listTitle !== 'undefined';
+        telemetryProps.listUrl = typeof args.options.listUrl !== 'undefined';
+        telemetryProps.scope = typeof args.options.scope !== 'undefined';
+        telemetryProps.id = typeof args.options.id !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        let requestUrl = `${args.options.webUrl}/_api/`;
+        let listUrl = '';
+        let filter = '?$filter=';
+        if (args.options.listId) {
+            listUrl = `lists(guid'${encodeURIComponent(args.options.listId)}')/`;
+        }
+        else if (args.options.listTitle) {
+            listUrl = `lists/getByTitle('${encodeURIComponent(args.options.listTitle)}')/`;
+        }
+        else if (args.options.listUrl) {
+            const listServerRelativeUrl = utils_1.urlUtil.getServerRelativePath(args.options.webUrl, args.options.listUrl);
+            listUrl = `GetList('${encodeURIComponent(listServerRelativeUrl)}')/`;
+        }
+        if (!args.options.scope || args.options.scope === 'web') {
+            requestUrl += `web/${listUrl}eventreceivers`;
+        }
+        else {
+            requestUrl += 'site/eventreceivers';
+        }
+        if (args.options.id) {
+            filter += `receiverid eq (guid'${args.options.id}')`;
+        }
+        else {
+            filter += `receivername eq '${args.options.name}'`;
+        }
+        const requestOptions = {
+            url: requestUrl + filter,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        request_1.default
+            .get(requestOptions)
+            .then((res) => {
+            logger.log(res.value);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-u, --webUrl <webUrl>'
+            },
+            {
+                option: '--listTitle [listTitle]'
+            },
+            {
+                option: '--listId  [listId]'
+            },
+            {
+                option: '--listUrl [listUrl]'
+            },
+            {
+                option: '-n, --name [name]'
+            },
+            {
+                option: '-i, --id [id]'
+            },
+            {
+                option: '-s, --scope [scope]',
+                autocomplete: ['web', 'site']
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    optionSets() {
+        return [
+            ['name', 'id']
+        ];
+    }
+    validate(args) {
+        const isValidSharePointUrl = utils_1.validation.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        const listOptions = [args.options.listId, args.options.listTitle, args.options.listUrl];
+        if (listOptions.some(item => item !== undefined) && listOptions.filter(item => item !== undefined).length > 1) {
+            return `Specify either list id or title or list url`;
+        }
+        if (args.options.listId && !utils_1.validation.isValidGuid(args.options.listId)) {
+            return `${args.options.listId} is not a valid GUID`;
+        }
+        if (args.options.scope && ['web', 'site'].indexOf(args.options.scope) === -1) {
+            return `${args.options.scope} is not a valid type value. Allowed values web|site.`;
+        }
+        if (args.options.scope && args.options.scope === 'site' && (args.options.listId || args.options.listUrl || args.options.listTitle)) {
+            return 'Scope cannot be set to site when retrieving list event receivers.';
+        }
+        return true;
+    }
+}
+module.exports = new SpoEventreceiverGetCommand();
+//# sourceMappingURL=eventreceiver-get.js.map

package/dist/m365/spo/commands/list/list-view-add.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../../utils");
+const request_1 = require("../../../../request");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoListViewAddCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.LIST_VIEW_ADD;
+    }
+    get description() {
+        return 'Adds a new view to a SharePoint list.';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.listId = typeof args.options.listId !== 'undefined';
+        telemetryProps.listTitle = typeof args.options.listTitle !== 'undefined';
+        telemetryProps.listUrl = typeof args.options.listUrl !== 'undefined';
+        telemetryProps.title = typeof args.options.title !== 'undefined';
+        telemetryProps.personal = !!args.options.personal;
+        telemetryProps.default = !!args.options.default;
+        telemetryProps.orderedView = !!args.options.orderedView;
+        telemetryProps.paged = !!args.options.paged;
+        telemetryProps.rowLimit = typeof args.options.rowLimit !== 'undefined';
+        return telemetryProps;
+    }
+    commandAction(logger, args, cb) {
+        const requestOptions = {
+            url: this.getRestUrl(args.options),
+            headers: {
+                'content-type': 'application/json;odata=verbose',
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json',
+            data: {
+                parameters: {
+                    Title: args.options.title,
+                    ViewFields: {
+                        results: args.options.fields.split(',')
+                    },
+                    PersonalView: !!args.options.personal,
+                    SetAsDefaultView: !!args.options.default,
+                    Paged: !!args.options.paged,
+                    RowLimit: args.options.rowLimit ? +args.options.rowLimit : 30
+                }
+            }
+        };
+        request_1.default
+            .post(requestOptions)
+            .then((result) => {
+            logger.log(result);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    getRestUrl(options) {
+        let result = `${options.webUrl}/_api/web/`;
+        if (options.listId) {
+            result += `lists(guid'${encodeURIComponent(options.listId)}')`;
+        }
+        else if (options.listTitle) {
+            result += `lists/getByTitle('${encodeURIComponent(options.listTitle)}')`;
+        }
+        else if (options.listUrl) {
+            result += `GetList('${encodeURIComponent(utils_1.urlUtil.getServerRelativePath(options.webUrl, options.listUrl))}')`;
+        }
+        result += '/views/add';
+        return result;
+    }
+    optionSets() {
+        return [
+            ['listId', 'listTitle', 'listUrl']
+        ];
+    }
+    options() {
+        const options = [
+            { option: '-u, --webUrl <webUrl>' },
+            { option: '--listId [listId]' },
+            { option: '--listTitle [listTitle]' },
+            { option: '--listUrl [listUrl]' },
+            { option: '--title <title>' },
+            { option: '--fields <fields>' },
+            { option: '--personal' },
+            { option: '--default' },
+            { option: '--paged' },
+            { option: '--rowLimit [rowLimit]' }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        const webUrlValidation = utils_1.validation.isValidSharePointUrl(args.options.webUrl);
+        if (webUrlValidation !== true) {
+            return webUrlValidation;
+        }
+        if (args.options.listId && !utils_1.validation.isValidGuid(args.options.listId)) {
+            return `${args.options.listId} in option listId is not a valid GUID`;
+        }
+        if (args.options.rowLimit !== undefined) {
+            if (isNaN(args.options.rowLimit)) {
+                return `${args.options.rowLimit} is not a number`;
+            }
+            if (+args.options.rowLimit <= 0) {
+                return 'rowLimit option must be greater than 0.';
+            }
+        }
+        if (args.options.personal && args.options.default) {
+            return 'Default view cannot be a personal view.';
+        }
+        return true;
+    }
+}
+module.exports = new SpoListViewAddCommand();
+//# sourceMappingURL=list-view-add.js.map

package/dist/m365/spo/commands.js

@@ -35,6 +35,7 @@ exports.default = {
     CUSTOMACTION_SET: `${prefix} customaction set`,
     CUSTOMACTION_LIST: `${prefix} customaction list`,
     CUSTOMACTION_REMOVE: `${prefix} customaction remove`,
+    EVENTRECEIVER_GET: `${prefix} eventreceiver get`,
     EXTERNALUSER_LIST: `${prefix} externaluser list`,
     FEATURE_DISABLE: `${prefix} feature disable`,
     FEATURE_ENABLE: `${prefix} feature enable`,
@@ -100,6 +101,7 @@ exports.default = {
     LIST_ROLEINHERITANCE_RESET: `${prefix} list roleinheritance reset`,
     LIST_SET: `${prefix} list set`,
     LIST_SITESCRIPT_GET: `${prefix} list sitescript get`,
+    LIST_VIEW_ADD: `${prefix} list view add`,
     LIST_VIEW_GET: `${prefix} list view get`,
     LIST_VIEW_LIST: `${prefix} list view list`,
     LIST_VIEW_REMOVE: `${prefix} list view remove`,

package/docs/docs/cmd/search/externalconnection/externalconnection-list.md

@@ -0,0 +1,21 @@
+# search externalconnection list
+
+Lists external connections defined in Microsoft Search
+
+## Usage
+
+```sh
+m365 search externalconnection list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List external connections defined in Microsoft Search
+
+```sh
+m365 search externalconnection list
+```

package/docs/docs/cmd/spo/eventreceiver/eventreceiver-get.md

@@ -0,0 +1,70 @@
+# spo eventreceiver get
+
+Retrieves specific event receiver for the specified web, site or list by event receiver name or id.
+
+## Usage
+
+```sh
+m365 spo eventreceiver get [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the web for which to retrieve the event receivers.
+
+`--listTitle [listTitle]`
+: The title of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_.
+Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: The id of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_.
+Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: The url of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_.
+Specify either `listTitle`, `listId` or `listUrl`.
+
+`-n, --name [name]`
+The name of the event receiver to retrieve. Specify either `name` or `id` but not both.
+
+`-i, --id [id]`
+The id of the event receiver to retrieve. Specify either `name` or `id` but not both.
+
+`-s, --scope [scope]`
+: The scope of which to retrieve the Event Receivers.
+Can be either "site" or "web". Defaults to "web". Only applicable when not specifying any of the list properties.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieve event receivers in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with name _PnP Test Receiver_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name 'PnP Test Receiver'
+```
+
+Retrieve event receivers in site _<https://contoso.sharepoint.com/sites/contoso-sales>_ with id _c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --scope site --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+```
+
+Retrieve event receivers for list with title _Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with name _PnP Test Receiver_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --name 'PnP Test Receiver'
+```
+
+Retrieve event receivers for list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with id _c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991' --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+```
+
+Retrieve event receivers for list with url _/sites/contoso-sales/lists/Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with name _PnP Test Receiver_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events' --name 'PnP Test Receiver'
+```

package/docs/docs/cmd/spo/list/list-view-add.md

@@ -0,0 +1,67 @@
+# spo list view add
+
+Adds a new view to a SharePoint list
+
+## Usage
+
+```sh
+m365 spo list view add [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`--listId [listId]`
+: ID of the list to which the view should be added. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
+
+`--listTitle [listTitle]`
+: Title of the list to which the view should be added. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
+
+`--listUrl [listUrl]`
+: Relative URL of the list to which the view should be added. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
+
+`--title <title>`
+: Title of the view to be created for the list.
+
+`--fields <fields>`
+: Comma-separated list of **case-sensitive** internal names of the fields to add to the view. 
+
+`--personal`
+: View will be created as personal view, if specified.
+
+`--default`
+: View will be set as default view, if specified.
+
+`--paged`
+: View supports paging, if specified (recommended to use this).
+
+`--rowLimit [rowLimit]`
+: Sets the number of items to display for the view. Default value is 30.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+We recommend using the `paged` option. When specified, the view supports displaying more items page by page (default behavior). When not specified, the `rowLimit` is absolute, and there is no link to see more items.
+
+## Examples
+
+Add a view called _All events_ to a list with specific title.
+
+```sh
+spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1,FieldName2,Created,Author,Modified,Editor" --paged
+```
+
+Add a view as default view with title _All events_ to a list with a specific URL.
+
+```sh
+spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/Lists/MyList" --title "All events" --fields "FieldName1,Created" --paged --default
+```
+
+Add a personal view called _All events_ to a list with a specific ID.
+
+```sh
+spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 00000000-0000-0000-0000-000000000000 --title "All events" --fields "FieldName1,Created" --paged --personal
+```

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "5.3.0",
+      "version": "5.4.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-node": "^1.8.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.3.0-beta.ebb13d0",
+  "version": "5.4.0-beta.694dbc5",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -174,6 +174,7 @@
     "van Iersel, Cas <cvaniersel@portiva.nl>",
     "van Rousselt, Rick <rick.vanrousselt@outlook.com>",
     "Velliah, Joseph <joseph@sprider.org>",
+    "Verbeeck, Mathijs <verbeeckmathijs@gmail.com>",
     "Waegebaert, Jasey <jaseyw@gmigroup.be>",
     "Wilen, Wictor <wictor@wictorwilen.se>",
     "Williams, Rabia <rabiawilliams@gmail.com>",