@pnp/cli-microsoft365 5.0.0 → 5.1.0-beta.04832fc

package/dist/utils/validation.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validation = void 0;
+exports.validation = {
+    isValidGuidArray(guids) {
+        return guids.every(guid => this.isValidGuid(guid));
+    },
+    isValidGuid(guid) {
+        const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
+        return guidRegEx.test(guid);
+    },
+    isValidTeamsChannelId(guid) {
+        const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+@thread\.(skype|tacv2)$/i);
+        return guidRegEx.test(guid);
+    },
+    isValidTeamsChatId(guid) {
+        const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+(@thread\.v2|@unq\.gbl\.spaces)$/i);
+        return guidRegEx.test(guid);
+    },
+    isValidUserPrincipalName(upn) {
+        const upnRegEx = new RegExp(/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/i);
+        return upnRegEx.test(upn);
+    },
+    isDateInRange(date, monthOffset) {
+        const d = new Date(date);
+        const cutoffDate = new Date();
+        cutoffDate.setMonth(cutoffDate.getMonth() - monthOffset);
+        return d > cutoffDate;
+    },
+    isValidISODate(date) {
+        const dateRegEx = new RegExp(/^(19|20)\d\d[- /.](0[1-9]|1[012])[- /.](0[1-9]|[12][0-9]|3[01])$/i);
+        return dateRegEx.test(date);
+    },
+    isValidISODateDashOnly(date) {
+        const dateTimeRegEx = new RegExp(/^(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z))|(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d([+-][0-2]\d:[0-5]\d|Z))|(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d([+-][0-2]\d:[0-5]\d|Z))$/i);
+        const dateOnlyRegEx = new RegExp(/^(19|20)\d\d[-](0[1-9]|1[012])[-](0[1-9]|[12][0-9]|3[01])$/i);
+        return dateTimeRegEx.test(date) ? true : dateOnlyRegEx.test(date);
+    },
+    isValidISODateTime(dateTime) {
+        const withMilliSecsPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])\.[0-9]{3}Z$/);
+        if (withMilliSecsPattern.test(dateTime)) {
+            return true;
+        }
+        const withSecsPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])Z$/);
+        if (withSecsPattern.test(dateTime)) {
+            return true;
+        }
+        const withMinutesPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9])Z$/);
+        if (withMinutesPattern.test(dateTime)) {
+            return true;
+        }
+        const withHoursPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3])Z$/);
+        if (withHoursPattern.test(dateTime)) {
+            return true;
+        }
+        const withoutTimePattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))$/);
+        if (withoutTimePattern.test(dateTime)) {
+            return true;
+        }
+        return false;
+    },
+    isValidBoolean(value) {
+        return value.toLowerCase() === 'true' || value.toLowerCase() === 'false';
+    },
+    isJavaScriptReservedWord(input) {
+        const javascriptReservedWords = [
+            "arguments",
+            "await",
+            "break",
+            "case",
+            "catch",
+            "class",
+            "const",
+            "continue",
+            "debugger",
+            "default",
+            "delete",
+            "do",
+            "else",
+            "enum",
+            "eval",
+            "export",
+            "extends",
+            "false",
+            "finally",
+            "for",
+            "function",
+            "if",
+            "implements",
+            "import",
+            "in",
+            "instanceof",
+            "interface",
+            "let",
+            "new",
+            "null",
+            "package",
+            "private",
+            "protected",
+            "public",
+            "return",
+            "static",
+            "super",
+            "switch",
+            "this",
+            "throw",
+            "true",
+            "try",
+            "typeof",
+            "var",
+            "void",
+            "while",
+            "with",
+            "yield",
+            "Array",
+            "Date",
+            "eval",
+            "function",
+            "hasOwnProperty",
+            "Infinity",
+            "isFinite",
+            "isNaN",
+            "isPrototypeOf",
+            "length",
+            "Math",
+            "NaN",
+            "name",
+            "Number",
+            "Object",
+            "prototype",
+            "String",
+            "toString",
+            "undefined",
+            "valueOf",
+            "alert",
+            "all",
+            "anchor",
+            "anchors",
+            "area",
+            "assign",
+            "blur",
+            "button",
+            "checkbox",
+            "clearInterval",
+            "clearTimeout",
+            "clientInformation",
+            "close",
+            "closed",
+            "confirm",
+            "constructor",
+            "crypto",
+            "decodeURI",
+            "decodeURIComponent",
+            "defaultStatus",
+            "document",
+            "element",
+            "elements",
+            "embed",
+            "embeds",
+            "encodeURI",
+            "encodeURIComponent",
+            "escape",
+            "event",
+            "fileUpload",
+            "focus",
+            "form",
+            "forms",
+            "frame",
+            "innerHeight",
+            "innerWidth",
+            "layer",
+            "layers",
+            "link",
+            "location",
+            "mimeTypes",
+            "navigate",
+            "navigator",
+            "frames",
+            "frameRate",
+            "hidden",
+            "history",
+            "image",
+            "images",
+            "offscreenBuffering",
+            "open",
+            "opener",
+            "option",
+            "outerHeight",
+            "outerWidth",
+            "packages",
+            "pageXOffset",
+            "pageYOffset",
+            "parent",
+            "parseFloat",
+            "parseInt",
+            "password",
+            "pkcs11",
+            "plugin",
+            "prompt",
+            "propertyIsEnum",
+            "radio",
+            "reset",
+            "screenX",
+            "screenY",
+            "scroll",
+            "secure",
+            "select",
+            "self",
+            "setInterval",
+            "setTimeout",
+            "status",
+            "submit",
+            "taint",
+            "text",
+            "textarea",
+            "top",
+            "unescape",
+            "untaint",
+            "window",
+            "onblur",
+            "onclick",
+            "onerror",
+            "onfocus",
+            "onkeydown",
+            "onkeypress",
+            "onkeyup",
+            "onmouseover",
+            "onload",
+            "onmouseup",
+            "onmousedown",
+            "onsubmit"
+        ];
+        return !!input && !input.split('.').every(value => !~javascriptReservedWords.indexOf(value));
+    },
+    isValidFileName(input) {
+        return !!input && !/^((\..*)|COM\d|CLOCK\$|LPT\d|AUX|NUL|CON|PRN|(.*[\u{d800}-\u{dfff}]+.*))$/iu.test(input) && !/^(.*\.\..*)$/i.test(input);
+    },
+    isValidTheme(input) {
+        const validThemeProperties = [
+            "themePrimary",
+            "themeLighterAlt",
+            "themeLighter",
+            "themeLight",
+            "themeTertiary",
+            "themeSecondary",
+            "themeDarkAlt",
+            "themeDark",
+            "themeDarker",
+            "neutralLighterAlt",
+            "neutralLighter",
+            "neutralLight",
+            "neutralQuaternaryAlt",
+            "neutralQuaternary",
+            "neutralTertiaryAlt",
+            "neutralTertiary",
+            "neutralSecondary",
+            "neutralPrimaryAlt",
+            "neutralPrimary",
+            "neutralDark",
+            "black",
+            "white"
+        ];
+        let theme;
+        try {
+            theme = JSON.parse(input);
+        }
+        catch (_a) {
+            return false;
+        }
+        if (Array.isArray(theme)) {
+            return false;
+        }
+        const hasInvalidProperties = validThemeProperties.map((property) => {
+            return theme.hasOwnProperty(property);
+        }).includes(false);
+        if (hasInvalidProperties) {
+            return false;
+        }
+        const regex = new RegExp(/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/);
+        const hasInvalidValues = validThemeProperties.map((property) => {
+            return regex.test(theme[property]);
+        }).includes(false);
+        if (hasInvalidValues) {
+            return false;
+        }
+        return true;
+    },
+    isValidSharePointUrl(url) {
+        if (!url) {
+            return false;
+        }
+        if (url.indexOf('https://') !== 0) {
+            return `${url} is not a valid SharePoint Online site URL`;
+        }
+        else {
+            return true;
+        }
+    },
+    isValidFormDigest(contextInfo) {
+        if (!contextInfo) {
+            return false;
+        }
+        const now = new Date();
+        if (contextInfo.FormDigestValue && now < contextInfo.FormDigestExpiresAt) {
+            return true;
+        }
+        return false;
+    }
+};
+//# sourceMappingURL=validation.js.map

package/docs/docs/cmd/aad/o365group/o365group-add.md

@@ -1,6 +1,6 @@
 # aad o365group add
 
-Creates Microsoft 365 Group
+Creates a Microsoft 365 Group
 
 ## Usage
 
@@ -28,6 +28,18 @@ m365 aad o365group add [options]
 `--isPrivate [isPrivate]`
 : Set to `true` if the Microsoft 365 Group should be private and to `false` if it should be public (default)
 
+`--allowMembersToPost [allowMembersToPost]`
+: Set if only group members should be able to post conversations to the group
+
+`--hideGroupInOutlook [hideGroupInOutlook]`
+: Set to hide the group in Outlook experiences
+
+`--subscribeNewGroupMembers [subscribeNewGroupMembers]`
+: Set to subscribe all new group members to receive group conversation emails when new messages are posted in the group
+
+`--welcomeEmailDisabled [welcomeEmailDisabled]`
+: Set to not send welcome emails to new group members
+
 `-l, --logoPath [logoPath]`
 : Local path to the image file to use as group logo
 
@@ -43,29 +55,53 @@ If an invalid user is provided in the comma-separated list or Owners or Members,
 Create a public Microsoft 365 Group
 
 ```sh
-m365 aad o365group add --displayName Finance --description 'This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.' --mailNickname finance
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance
 ```
 
 Create a private Microsoft 365 Group
 
 ```sh
-m365 aad o365group add --displayName Finance --description 'This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.' --mailNickname finance --isPrivate true
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --isPrivate true
 ```
 
 Create a public Microsoft 365 Group and set specified users as its owners
 
 ```sh
-m365 aad o365group add --displayName Finance --description 'This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.' --mailNickname finance --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
 Create a public Microsoft 365 Group and set specified users as its members
 
 ```sh
-m365 aad o365group add --displayName Finance --description 'This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.' --mailNickname finance --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
+```
+
+Create a public Microsoft 365 Group and allows only group members to be able to post conversations to the group.
+
+```sh
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --allowMembersToPost
+```
+
+Create a public Microsoft 365 Group and hides it from the Outlook experiences (web and client).
+
+```sh
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --hideGroupInOutlook
+```
+
+Create a public Microsoft 365 Group and subscribe all new group members to receive group conversation emails when new messages are posted in the group.
+
+```sh
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --subscribeNewGroupMembers
+```
+
+Create a public Microsoft 365 Group and set to not send welcome emails to new group members.
+
+```sh
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --welcomeEmailDisabled
 ```
 
 Create a public Microsoft 365 Group and set its logo
 
 ```sh
-m365 aad o365group add --displayName Finance --description 'This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.' --mailNickname finance --logoPath images/logo.png
+m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --logoPath images/logo.png
 ```

package/docs/docs/cmd/aad/o365group/o365group-conversation-post-list.md

@@ -0,0 +1,36 @@
+# aad o365group conversation post list
+
+Lists conversation posts of a Microsoft 365 group
+
+## Usage
+
+```sh
+m365 aad o365group conversation post list [options]
+```
+
+## Options
+
+`-i, --groupId [groupId]`
+: The Id of the Office 365 Group. You can specify the groupId or groupDisplayName, but not both.
+
+`-d, --groupDisplayName [groupDisplayName]`
+: The Displayname of the Office 365 Group. You can specify the groupId or groupDisplayName, but not both.
+
+`-t, --threadId <threadId>`
+: The ID of the thread to retrieve details for
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Lists the posts of the specific conversation of Microsoft 365 group by groupId
+
+```sh
+m365 aad o365group conversation post list --groupId '00000000-0000-0000-0000-000000000000' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
+```
+
+Lists the posts of the specific conversation of Microsoft 365 group by groupDisplayName
+
+```sh
+m365 aad o365group conversation post list --groupDisplayName 'MyGroup' --threadId 'AAQkADkwN2Q2NDg1LWQ3ZGYtNDViZi1iNGRiLTVhYjJmN2Q5NDkxZQAQAOnRAfDf71lIvrdK85FAn5E='
+```

package/docs/docs/cmd/planner/plan/plan-details-get.md

@@ -0,0 +1,45 @@
+# planner plan details get
+
+Retrieve the planner details about the specified plan.
+
+## Usage
+
+```sh
+m365 planner plan details get [options]
+```
+
+## Options
+
+`-i, --planId [planId]`
+: ID of the plan. Specify either `planId` or `planTitle` but not both.
+
+`-t, --planTitle [planTitle]`
+: Title of the plan. Specify either `planId` or `planTitle` but not both.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Returns the Microsoft Planner plan details with id _gndWOTSK60GfPQfiDDj43JgACDCb_
+
+```sh
+m365 planner plan details get --planId "gndWOTSK60GfPQfiDDj43JgACDCb"
+```
+
+Returns the Microsoft Planner plan details with title _MyPlan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
+
+```sh
+m365 planner plan details get --planTitle "MyPlan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"
+```
+
+Returns the Microsoft Planner plan details with title _MyPlan_ for Group _My Planner Group_
+
+```sh
+m365 planner plan details get --planTitle "MyPlan" --ownerGroupName "My Planner Group"
+```

package/docs/docs/cmd/spfx/project/project-upgrade.md

@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.14.0).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.14.0). If you specify the `preview` option without a specific version, the command will upgrade your project to the latest preview version v1.15.0-beta.1.
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spo/site/site-recyclebinitem-restore.md

@@ -0,0 +1,27 @@
+# spo site recyclebinitem restore
+
+Restores given items from the site recycle bin
+
+## Usage
+
+```sh
+m365 spo site recyclebinitem restore [options]
+```
+
+## Options
+
+`-u, --siteUrl <siteUrl>`
+: URL of the site for which to restore the recycle bin items
+
+`-i, --ids <ids>`
+: List of ids of items which will be restored from the site recycle bin
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Restore specific items by given ids from recycle bin for site _https://contoso.sharepoint.com/site_
+
+```sh
+m365 spo site recyclebinitem restore --siteUrl https://contoso.sharepoint.com/site --ids "ae6f97a7-280e-48d6-b481-0ea986c323da,aadbf916-1f71-42ee-abf2-8ee4802ae291"
+```

package/docs/docs/cmd/teams/chat/chat-message-send.md

@@ -33,23 +33,23 @@ A new chat conversation will be created if no existing conversation with the par
 Send a message to a Microsoft Teams chat conversation by id
 
 ```sh
-m365 teams chat message send --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
+m365 teams chat message send --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2 --message "Welcome to Teams"
 ```
 
 Send a message to a single person
 
 ```sh
-m365 teams chat message send --userEmails alexw@contoso.com
+m365 teams chat message send --userEmails alexw@contoso.com --message "Welcome to Teams"
 ```
 
 Send a message to a group of people
 
 ```sh
-m365 teams chat message send --userEmails alexw@contoso.com,meganb@contoso.com
+m365 teams chat message send --userEmails alexw@contoso.com,meganb@contoso.com --message "Welcome to Teams"
 ```
 
 Send a message to a chat conversation finding it by display name
 
 ```sh
-m365 teams chat message send --chatName "Just a conversation"
+m365 teams chat message send --chatName "Just a conversation" --message "Welcome to Teams"
 ```