@pnp/cli-microsoft365 5.2.0-beta.0f1c454 → 5.2.0-beta.a814a27

package/dist/m365/teams/commands/chat/chatUtil.js

@@ -0,0 +1,62 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatUtil = void 0;
+const odata_1 = require("../../../../utils/odata");
+exports.chatUtil = {
+    /**
+     * Finds existing Microsoft Teams chats by participants, using the Microsoft Graph
+     * @param expectedMemberEmails a string array of participant emailaddresses
+     * @param logger a logger to pipe into the graph request odata helper.
+     */
+    findExistingChatsByParticipants(expectedMemberEmails, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const chatType = expectedMemberEmails.length === 2 ? 'oneOnOne' : 'group';
+            const endpoint = `https://graph.microsoft.com/v1.0/chats?$filter=chatType eq '${chatType}'&$expand=members&$select=id,topic,createdDateTime,members`;
+            const foundChats = [];
+            const chats = yield odata_1.odata.getAllItems(endpoint, logger);
+            for (const chat of chats) {
+                const chatMembers = chat.members;
+                if (chatMembers.length === expectedMemberEmails.length) {
+                    const chatMemberEmails = chatMembers.map(member => { var _a; return (_a = member.email) === null || _a === void 0 ? void 0 : _a.toLowerCase(); });
+                    if (expectedMemberEmails.every(email => chatMemberEmails.some(memberEmail => memberEmail === email))) {
+                        foundChats.push(chat);
+                    }
+                }
+            }
+            return foundChats;
+        });
+    },
+    /**
+     * Finds existing Microsoft Teams chats by name, using the Microsoft Graph
+     * @param name the name of the chat conversation to find
+     * @param logger a logger to pipe into the graph request odata helper.
+     */
+    findExistingGroupChatsByName(name, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = `https://graph.microsoft.com/v1.0/chats?$filter=topic eq '${encodeURIComponent(name).replace("'", "''")}'&$expand=members&$select=id,topic,createdDateTime,chatType`;
+            return odata_1.odata.getAllItems(endpoint, logger);
+        });
+    },
+    /**
+     * Converts a comma or space separated string into an array.
+     * @param value the string to convert
+     */
+    convertParticipantStringToArray(value) {
+        if (value.indexOf(',') === -1) {
+            return value.trim().toLowerCase().split(' ').filter(e => e && e !== '');
+        }
+        else {
+            return value.trim().toLowerCase().split(',').filter(e => e && e !== '');
+        }
+    }
+};
+//# sourceMappingURL=chatUtil.js.map

package/dist/m365/teams/commands.js

@@ -11,8 +11,10 @@ exports.default = {
     CHANNEL_ADD: `${prefix} channel add`,
     CHANNEL_GET: `${prefix} channel get`,
     CHANNEL_LIST: `${prefix} channel list`,
+    CHANNEL_MEMBERSHIP_LIST: `${prefix} channel membership list`,
     CHANNEL_REMOVE: `${prefix} channel remove`,
     CHANNEL_SET: `${prefix} channel set`,
+    CHAT_GET: `${prefix} chat get`,
     CHAT_LIST: `${prefix} chat list`,
     CHAT_MEMBER_LIST: `${prefix} chat member list`,
     CHAT_MESSAGE_LIST: `${prefix} chat message list`,

package/dist/settingsNames.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.settingsNames = void 0;
 const settingsNames = {
     autoOpenBrowserOnLogin: 'autoOpenBrowserOnLogin',
+    autoOpenLinksInBrowser: 'autoOpenLinksInBrowser',
     copyDeviceCodeToClipboard: 'copyDeviceCodeToClipboard',
     csvEscape: 'csvEscape',
     csvHeader: 'csvHeader',

package/dist/utils/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./accessToken"), exports);
 __exportStar(require("./formatting"), exports);
 __exportStar(require("./fsUtil"), exports);
+__exportStar(require("./md"), exports);
 __exportStar(require("./odata"), exports);
 __exportStar(require("./packageManager"), exports);
 __exportStar(require("./sinonUtil"), exports);

package/dist/utils/md.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.md = void 0;
+const fs = require("fs");
+const os_1 = require("os");
+const path = require("path");
+function convertTitle(md) {
+    return md.replace(/^#\s+(.*)/gm, (match, title) => {
+        return title.toLocaleUpperCase() + os_1.EOL + Array(title.length + 1).join('=');
+    });
+}
+function convertHeadings(md) {
+    return md.replace(/^(#+)\s+(.*)/gm, (match, level, content) => {
+        return `${os_1.EOL}${content.toLocaleUpperCase()}`;
+    });
+}
+function convertAdmonitions(md) {
+    const regex = new RegExp('^!!!\\s(.*)' + os_1.EOL + '\\s+', 'gm');
+    return md.replace(regex, (match, content) => {
+        return content.toLocaleUpperCase() + os_1.EOL + os_1.EOL;
+    });
+}
+function includeContent(md, rootFolder) {
+    return md.replace(/^--8<-- "([^"]+)"/gm, (match, filePath) => {
+        return fs.readFileSync(path.join(rootFolder, filePath), 'utf8');
+    });
+}
+function convertDd(md) {
+    return md.replace(/^:\s(.*)/gm, (match, content) => {
+        return `  ${content}`;
+    });
+}
+function convertHyperlinks(md) {
+    return md.replace(/\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
+        // if the link is the same as the content, return just the link
+        if (label === url) {
+            return url;
+        }
+        // if the link is relative, remove it because there's no way to open it
+        // from the terminal anyway. In the future, we could convert it to the
+        // actual link of the docs.
+        if (!url.startsWith('http:') && !url.startsWith('https:')) {
+            return label;
+        }
+        return `${label} (${url})`;
+    });
+}
+function convertCodeFences(md) {
+    const regex = new RegExp('^```.*?' + os_1.EOL + '(.*?)```' + os_1.EOL, 'gms');
+    return md.replace(regex, (match, code) => {
+        return `  ${code}${os_1.EOL}`;
+    });
+}
+function removeInlineMarkup(md) {
+    // from https://stackoverflow.com/a/70064453
+    return md.replace(/(?<marks>[`]|\*{1,3}|_{1,3}|~{2})(?<inmarks>.*?)\1/g, '$<inmarks>$<link_text>');
+}
+function removeTooManyEmptyLines(md) {
+    const regex = new RegExp('(' + os_1.EOL + '){4,}', 'g');
+    return md.replace(regex, Array(4).join(os_1.EOL));
+}
+const convertFunctions = [
+    convertTitle,
+    convertHeadings,
+    convertAdmonitions,
+    convertDd,
+    convertHyperlinks,
+    convertCodeFences,
+    removeInlineMarkup,
+    removeTooManyEmptyLines
+];
+exports.md = {
+    md2plain(md, rootFolderDocs) {
+        md = includeContent(md, rootFolderDocs);
+        convertFunctions.forEach(convert => {
+            md = convert(md);
+        });
+        return md;
+    }
+};
+//# sourceMappingURL=md.js.map

package/docs/docs/cmd/teams/channel/channel-membership-list.md

@@ -0,0 +1,48 @@
+# teams channel membership list
+
+Lists memberships in the specified Microsoft Teams team channel
+
+## Usage
+
+```sh
+m365 teams channel membership list [options]
+```
+
+## Options
+
+`--teamId [teamId]`
+: The Id of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both
+
+`--teamName [teamName]`
+: The display name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both
+
+`--channelId [channelId]`
+: The Id of the Microsoft Teams team channel. Specify either `channelId` or `channelName` but not both
+
+`channelName [channelName]`
+: The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName` but not both
+
+`-r, --role [role]`
+: Filter the results to only users with the given role: owner, member, guest
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+  
+List the memberships in a specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000 and channel id 00:00000000000000000000000000000000@thread.skype
+
+```sh
+m365 teams channel membership list --teamId 00000000-0000-0000-0000-000000000000 --channelId 00:00000000000000000000000000000000@thread.skype
+```
+
+List the memberships in a specified Microsoft Teams team with name _Team Name_ and channel with name _Channel Name_
+
+```sh
+m365 teams channel membership list --teamName "Team Name" --channelName "Channel Name"
+```
+
+List all owner memberships in the specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000 and channel id 00:00000000000000000000000000000000@thread.skype
+
+```sh
+m365 teams channel membership list --teamId 00000000-0000-0000-0000-000000000000 --channelId 00:00000000000000000000000000000000@thread.skype --role owner
+```

package/docs/docs/cmd/teams/chat/chat-get.md

@@ -0,0 +1,53 @@
+# teams chat get
+
+Get a Microsoft Teams chat conversation by id, participants or chat name.
+
+## Usage
+
+```sh
+m365 teams chat get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: The ID of the chat conversation. Specify either `id`, `name` or `participants`, but not multiple.
+
+`-n, --name [name]`
+: The display name of the chat conversation. Specify either `id`, `name` or `participants`, but not multiple.
+
+`-p, --participants [participants]`
+: A comma-separated list of one or more e-mail addresses. Specify either `id`, `name` or `participants`, but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+The output will not include the chat conversation members or messages. It will just retrieve the conversation details.
+When using the `participants` option, the signed-in user will automatically be included as a participant. There's no need to add it to the list manually.
+
+## Examples
+
+Get a Microsoft Teams chat conversation by id
+
+```sh
+m365 teams chat get --id 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
+```
+
+Get a Microsoft Teams one on one chat conversation, finding it by participant.
+
+```sh
+m365 teams chat get --participants alexw@contoso.com
+```
+
+Get a Microsoft Teams group chat conversation, finding it by participants.
+
+```sh
+m365 teams chat get --participants alexw@contoso.com,meganb@contoso.com
+```
+
+Get a Microsoft Teams chat conversation, finding it by display name
+
+```sh
+m365 teams chat get --name "Just a conversation"
+```