@pnp/cli-microsoft365 7.11.0-beta.c513557 → 8.0.0-beta.630e741

package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-set.js

@@ -76,7 +76,7 @@ class SpoTenantApplicationCustomizerSetCommand extends SpoCommand {
     }
     async getComponentManifest(appCatalogUrl, clientSideComponentId, logger) {
         if (this.verbose) {
-            logger.logToStderr('Retrieving component manifest item from the ComponentManifests list on the app catalog site so that we get the solution id');
+            await logger.logToStderr('Retrieving component manifest item from the ComponentManifests list on the app catalog site so that we get the solution id');
         }
         const camlQuery = `<View><ViewFields><FieldRef Name='ClientComponentId'></FieldRef><FieldRef Name='SolutionId'></FieldRef><FieldRef Name='ClientComponentManifest'></FieldRef></ViewFields><Query><Where><Eq><FieldRef Name='ClientComponentId' /><Value Type='Guid'>${clientSideComponentId}</Value></Eq></Where></Query></View>`;
         const commandOptions = {
@@ -89,7 +89,7 @@ class SpoTenantApplicationCustomizerSetCommand extends SpoCommand {
         };
         const output = await cli.executeCommandWithOutput(spoListItemListCommand, { options: { ...commandOptions, _: [] } });
         if (this.verbose) {
-            logger.logToStderr(output.stderr);
+            await logger.logToStderr(output.stderr);
         }
         const outputParsed = JSON.parse(output.stdout);
         if (outputParsed.length === 0) {
@@ -99,7 +99,7 @@ class SpoTenantApplicationCustomizerSetCommand extends SpoCommand {
     }
     async getSolutionFromAppCatalog(appCatalogUrl, solutionId, logger) {
         if (this.verbose) {
-            logger.logToStderr(`Retrieving solution with id ${solutionId} from the application catalog`);
+            await logger.logToStderr(`Retrieving solution with id ${solutionId} from the application catalog`);
         }
         const camlQuery = `<View><ViewFields><FieldRef Name='SkipFeatureDeployment'></FieldRef><FieldRef Name='ContainsTenantWideExtension'></FieldRef></ViewFields><Query><Where><Eq><FieldRef Name='AppProductID' /><Value Type='Guid'>${solutionId}</Value></Eq></Where></Query></View>`;
         const commandOptions = {
@@ -112,7 +112,7 @@ class SpoTenantApplicationCustomizerSetCommand extends SpoCommand {
         };
         const output = await cli.executeCommandWithOutput(spoListItemListCommand, { options: { ...commandOptions, _: [] } });
         if (this.verbose) {
-            logger.logToStderr(output.stderr);
+            await logger.logToStderr(output.stderr);
         }
         const outputParsed = JSON.parse(output.stdout);
         if (outputParsed.length === 0) {

package/dist/m365/spo/commands/tenant/tenant-commandset-set.js

@@ -44,7 +44,7 @@ class SpoTenantCommandSetSetCommand extends SpoCommand {
     }
     async getListItemById(logger, webUrl, listServerRelativeUrl, id) {
         if (this.verbose) {
-            logger.logToStderr(`Getting the list item by id ${id}`);
+            await logger.logToStderr(`Getting the list item by id ${id}`);
         }
         const reqOptions = {
             url: `${webUrl}/_api/web/GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')/Items(${id})`,
@@ -57,7 +57,7 @@ class SpoTenantCommandSetSetCommand extends SpoCommand {
     }
     async updateTenantWideExtension(appCatalogUrl, options, listServerRelativeUrl, logger) {
         if (this.verbose) {
-            logger.logToStderr('Updating tenant wide extension to the TenantWideExtensions list');
+            await logger.logToStderr('Updating tenant wide extension to the TenantWideExtensions list');
         }
         const formValues = [];
         if (options.newTitle !== undefined) {

package/dist/m365/spo/commands/user/user-ensure.js

@@ -27,7 +27,7 @@ class SpoUserEnsureCommand extends SpoCommand {
     async commandAction(logger, args) {
         if (args.options.aadId) {
             args.options.entraId = args.options.aadId;
-            this.warn(logger, `Option 'aadId' is deprecated. Please use 'entraId' instead`);
+            await this.warn(logger, `Option 'aadId' is deprecated. Please use 'entraId' instead`);
         }
         if (this.verbose) {
             await logger.logToStderr(`Ensuring user ${args.options.entraId || args.options.userName} at site ${args.options.webUrl}`);

package/dist/m365/spo/commands.js

@@ -31,6 +31,7 @@ export default {
     COMMANDSET_REMOVE: `${prefix} commandset remove`,
     COMMANDSET_SET: `${prefix} commandset set`,
     CONTENTTYPE_ADD: `${prefix} contenttype add`,
+    CONTENTTYPE_FIELD_LIST: `${prefix} contenttype field list`,
     CONTENTTYPE_FIELD_REMOVE: `${prefix} contenttype field remove`,
     CONTENTTYPE_FIELD_SET: `${prefix} contenttype field set`,
     CONTENTTYPE_GET: `${prefix} contenttype get`,

package/dist/m365/teams/commands/chat/chat-member-add.js

@@ -27,7 +27,7 @@ class TeamsChatMemberAddCommand extends GraphCommand {
     async commandAction(logger, args) {
         try {
             if (this.verbose) {
-                logger.logToStderr(`Adding member ${args.options.userId || args.options.userName} to chat with id ${args.options.chatId}...`);
+                await logger.logToStderr(`Adding member ${args.options.userId || args.options.userName} to chat with id ${args.options.chatId}...`);
             }
             const chatMemberAddOptions = {
                 url: `${this.resource}/v1.0/chats/${args.options.chatId}/members`,

package/dist/m365/teams/commands/meeting/meeting-attendancereport-get.js

@@ -0,0 +1,119 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TeamsMeetingAttendancereportGetCommand_instances, _TeamsMeetingAttendancereportGetCommand_initTelemetry, _TeamsMeetingAttendancereportGetCommand_initOptions, _TeamsMeetingAttendancereportGetCommand_initTypes, _TeamsMeetingAttendancereportGetCommand_initValidators, _TeamsMeetingAttendancereportGetCommand_initOptionSets;
+import auth from '../../../../Auth.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import { validation } from '../../../../utils/validation.js';
+import GraphCommand from "../../../base/GraphCommand.js";
+import commands from '../../commands.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import request from '../../../../request.js';
+class TeamsMeetingAttendancereportGetCommand extends GraphCommand {
+    get name() {
+        return commands.MEETING_ATTENDANCEREPORT_GET;
+    }
+    get description() {
+        return 'Gets attendance report for a given meeting';
+    }
+    constructor() {
+        super();
+        _TeamsMeetingAttendancereportGetCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAttendancereportGetCommand_instances, "m", _TeamsMeetingAttendancereportGetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAttendancereportGetCommand_instances, "m", _TeamsMeetingAttendancereportGetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAttendancereportGetCommand_instances, "m", _TeamsMeetingAttendancereportGetCommand_initTypes).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAttendancereportGetCommand_instances, "m", _TeamsMeetingAttendancereportGetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingAttendancereportGetCommand_instances, "m", _TeamsMeetingAttendancereportGetCommand_initOptionSets).call(this);
+    }
+    async commandAction(logger, args) {
+        try {
+            const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
+            if (isAppOnlyAccessToken && !args.options.userId && !args.options.userName && !args.options.email) {
+                throw `The option 'userId', 'userName' or 'email' is required when retrieving meeting attendance report using app only permissions.`;
+            }
+            else if (!isAppOnlyAccessToken && (args.options.userId || args.options.userName || args.options.email)) {
+                throw `The options 'userId', 'userName' and 'email' cannot be used when retrieving meeting attendance report using delegated permissions.`;
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving attendance report for ${isAppOnlyAccessToken ? `specific user ${args.options.userId || args.options.userName || args.options.email}.` : 'currently logged in user'}.`);
+            }
+            let userUrl = '';
+            if (isAppOnlyAccessToken) {
+                const userId = await this.getUserId(args.options);
+                userUrl += `users/${userId}`;
+            }
+            else {
+                userUrl += 'me';
+            }
+            const requestOptions = {
+                url: `${this.resource}/v1.0/${userUrl}/onlineMeetings/${args.options.meetingId}/attendanceReports/${args.options.id}?$expand=attendanceRecords`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const attendanceReport = await request.get(requestOptions);
+            await logger.log(attendanceReport);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getUserId(options) {
+        if (options.userId) {
+            return options.userId;
+        }
+        if (options.userName) {
+            return entraUser.getUserIdByUpn(options.userName);
+        }
+        return entraUser.getUserIdByEmail(options.email);
+    }
+}
+_TeamsMeetingAttendancereportGetCommand_instances = new WeakSet(), _TeamsMeetingAttendancereportGetCommand_initTelemetry = function _TeamsMeetingAttendancereportGetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            email: typeof args.options.email !== 'undefined'
+        });
+    });
+}, _TeamsMeetingAttendancereportGetCommand_initOptions = function _TeamsMeetingAttendancereportGetCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --userId [userId]'
+    }, {
+        option: '-n, --userName [userName]'
+    }, {
+        option: '--email [email]'
+    }, {
+        option: '-m, --meetingId <meetingId>'
+    }, {
+        option: '-i, --id <id>'
+    });
+}, _TeamsMeetingAttendancereportGetCommand_initTypes = function _TeamsMeetingAttendancereportGetCommand_initTypes() {
+    this.types.string.push('userId', 'userName', 'email', 'meetingId', 'id');
+}, _TeamsMeetingAttendancereportGetCommand_initValidators = function _TeamsMeetingAttendancereportGetCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (!validation.isValidGuid(args.options.id)) {
+            return `${args.options.id} is not a valid GUID for option 'id'.`;
+        }
+        if (args.options.userId && !validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID for option 'userId'.`;
+        }
+        if (args.options.userName && !validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid UPN.`;
+        }
+        if (args.options.email && !validation.isValidUserPrincipalName(args.options.email)) {
+            return `${args.options.email} is not a valid email.`;
+        }
+        return true;
+    });
+}, _TeamsMeetingAttendancereportGetCommand_initOptionSets = function _TeamsMeetingAttendancereportGetCommand_initOptionSets() {
+    this.optionSets.push({
+        options: ['userId', 'userName', 'email'],
+        runsWhen: (args) => args.options.userId || args.options.userName || args.options.email
+    });
+};
+export default new TeamsMeetingAttendancereportGetCommand();
+//# sourceMappingURL=meeting-attendancereport-get.js.map

package/dist/m365/teams/commands/meeting/meeting-list.js

@@ -90,7 +90,7 @@ class TeamsMeetingListCommand extends GraphCommand {
         let result = [];
         for (let i = 0; i < meetingUrls.length; i += 20) {
             if (this.verbose) {
-                logger.logToStderr(`Retrieving meetings ${i + 1}-${Math.min(i + 20, meetingUrls.length)}...`);
+                await logger.logToStderr(`Retrieving meetings ${i + 1}-${Math.min(i + 20, meetingUrls.length)}...`);
             }
             const batch = meetingUrls.slice(i, i + 20);
             const requestOptions = {

package/dist/m365/teams/commands.js

@@ -30,6 +30,7 @@ export default {
     MEETING_ADD: `${prefix} meeting add`,
     MEETING_GET: `${prefix} meeting get`,
     MEETING_LIST: `${prefix} meeting list`,
+    MEETING_ATTENDANCEREPORT_GET: `${prefix} meeting attendancereport get`,
     MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
     MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
     MEMBERSETTINGS_LIST: `${prefix} membersettings list`,

package/dist/m365/viva/commands/engage/engage-community-get.js

@@ -22,7 +22,7 @@ class VivaEngageCommunityGetCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         if (this.verbose) {
-            logger.logToStderr(`Getting the information of Viva Engage community with id '${args.options.id}'...`);
+            await logger.logToStderr(`Getting the information of Viva Engage community with id '${args.options.id}'...`);
         }
         const requestOptions = {
             url: `${this.resource}/beta/employeeExperience/communities/${args.options.id}`,

package/dist/request.js

@@ -14,39 +14,39 @@ class Request {
         }
         this._debug = debug;
         if (this._debug) {
-            this.req.interceptors.request.use(config => {
+            this.req.interceptors.request.use(async (config) => {
                 if (this._logger) {
-                    this._logger.logToStderr('Request:');
+                    await this._logger.logToStderr('Request:');
                     const properties = ['url', 'method', 'headers', 'responseType', 'decompress'];
                     if (config.responseType !== 'stream') {
                         properties.push('data');
                     }
-                    this._logger.logToStderr(JSON.stringify(formatting.filterObject(config, properties), null, 2));
+                    await this._logger.logToStderr(JSON.stringify(formatting.filterObject(config, properties), null, 2));
                 }
                 return config;
             });
             // since we're stubbing requests, response interceptor is never called in
             // tests, so let's exclude it from coverage
             /* c8 ignore next 26 */
-            this.req.interceptors.response.use((response) => {
+            this.req.interceptors.response.use(async (response) => {
                 if (this._logger) {
-                    this._logger.logToStderr('Response:');
+                    await this._logger.logToStderr('Response:');
                     const properties = ['status', 'statusText', 'headers'];
                     if (response.headers['content-type'] &&
                         response.headers['content-type'].indexOf('json') > -1) {
                         properties.push('data');
                     }
-                    this._logger.logToStderr(JSON.stringify({
+                    await this._logger.logToStderr(JSON.stringify({
                         url: response.config.url,
                         ...formatting.filterObject(response, properties)
                     }, null, 2));
                 }
                 return response;
-            }, (error) => {
+            }, async (error) => {
                 if (this._logger) {
                     const properties = ['status', 'statusText', 'headers'];
-                    this._logger.logToStderr('Request error:');
-                    this._logger.logToStderr(JSON.stringify({
+                    await this._logger.logToStderr('Request error:');
+                    await this._logger.logToStderr(JSON.stringify({
                         url: error.config?.url,
                         ...formatting.filterObject(error.response, properties),
                         error: error.error
@@ -169,7 +169,7 @@ class Request {
                     timings.api.push(Number(end - start));
                     _resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
-            }, (error) => {
+            }, async (error) => {
                 if (error && error.response &&
                     (error.response.status === 429 ||
                         error.response.status === 503)) {
@@ -178,11 +178,10 @@ class Request {
                         retryAfter = 10;
                     }
                     if (this._debug) {
-                        this._logger.log(`Request throttled. Waiting ${retryAfter}sec before retrying...`);
+                        await this._logger.log(`Request throttled. Waiting ${retryAfter}sec before retrying...`);
                     }
-                    setTimeout(() => {
-                        this.execute(options, resolve || _resolve, reject || _reject);
-                    }, retryAfter * 1000);
+                    // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                    setTimeout(async () => { this.execute(options, resolve || _resolve, reject || _reject); }, retryAfter * 1000);
                 }
                 else {
                     if (reject) {

package/dist/utils/formatting.js

@@ -9,6 +9,8 @@ export var CheckStatus;
 (function (CheckStatus) {
     CheckStatus[CheckStatus["Success"] = 0] = "Success";
     CheckStatus[CheckStatus["Failure"] = 1] = "Failure";
+    CheckStatus[CheckStatus["Information"] = 2] = "Information";
+    CheckStatus[CheckStatus["Warning"] = 3] = "Warning";
 })(CheckStatus || (CheckStatus = {}));
 export const formatting = {
     escapeXml(s) {
@@ -152,7 +154,18 @@ export const formatting = {
             process.env.TERM === 'xterm-256color';
         const success = primarySupported ? '✔' : '√';
         const failure = primarySupported ? '✖' : '×';
-        return `${result === CheckStatus.Success ? chalk.green(success) : chalk.red(failure)} ${message}`;
+        const information = 'i';
+        const warning = '!';
+        switch (result) {
+            case CheckStatus.Success:
+                return `${chalk.green(success)} ${message}`;
+            case CheckStatus.Failure:
+                return `${chalk.red(failure)} ${message}`;
+            case CheckStatus.Information:
+                return `${chalk.blue(information)} ${message}`;
+            case CheckStatus.Warning:
+                return `${chalk.yellow(warning)} ${message}`;
+        }
     },
     convertArrayToHashTable(key, array) {
         const resultAsKeyValuePair = {};

package/dist/utils/spo.js

@@ -1173,7 +1173,7 @@ export const spo = {
     */
     async getFileAsListItemByUrl(absoluteListUrl, url, logger, verbose) {
         if (verbose && logger) {
-            logger.logToStderr(`Getting the file properties with url ${url}`);
+            await logger.logToStderr(`Getting the file properties with url ${url}`);
         }
         const serverRelativePath = urlUtil.getServerRelativePath(absoluteListUrl, url);
         const requestUrl = `${absoluteListUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl=@f)?$expand=ListItemAllFields&@f='${formatting.encodeQueryParameter(serverRelativePath)}'`;
@@ -1206,7 +1206,7 @@ export const spo = {
         const serverRelativeSiteMatch = absoluteListUrl.match(new RegExp('/sites/[^/]+'));
         const webUrl = `${parsedUrl.protocol}//${parsedUrl.host}${serverRelativeSiteMatch ?? ''}`;
         if (verbose && logger) {
-            logger.logToStderr(`Getting list id...`);
+            await logger.logToStderr(`Getting list id...`);
         }
         const listRequestOptions = {
             url: `${absoluteListUrl}?$select=Id`,
@@ -1218,7 +1218,7 @@ export const spo = {
         const list = await request.get(listRequestOptions);
         const listId = list.Id;
         if (verbose && logger) {
-            logger.logToStderr(`Getting request digest for systemUpdate request`);
+            await logger.logToStderr(`Getting request digest for systemUpdate request`);
         }
         const res = await spo.getRequestDigest(webUrl);
         const formDigestValue = res.FormDigestValue;
@@ -1361,7 +1361,7 @@ export const spo = {
      */
     async getSiteId(webUrl, logger, verbose) {
         if (verbose && logger) {
-            logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
+            await logger.logToStderr(`Getting site id for URL: ${webUrl}...`);
         }
         const url = new URL(webUrl);
         const requestOptions = {
@@ -1393,7 +1393,7 @@ export const spo = {
         };
         const response = await request.post(requestOptions);
         if (verbose) {
-            logger.logToStderr('Attempt to get _ObjectIdentity_ key values');
+            await logger.logToStderr('Attempt to get _ObjectIdentity_ key values');
         }
         const json = JSON.parse(response);
         const contents = json.find(x => { return x.ErrorInfo; });

package/dist/utils/validation.js

@@ -1,3 +1,4 @@
+import { formatting } from "./formatting.js";
 export const validation = {
     isValidGuidArray(guidsString) {
         const guids = guidsString.split(',').map(guid => guid.trim());
@@ -33,6 +34,24 @@ export const validation = {
         // verify if the upn is a valid upn. @meusername will be replaced in a later stage with the actual username of the logged in user
         return upnRegEx.test(upn) || upn.toLowerCase().trim() === '@meusername';
     },
+    /**
+     * Validates if the provided number is a valid positive integer (1 or higher).
+     * @param integer Integer value.
+     * @returns True if integer, false otherwise.
+     */
+    isValidPositiveInteger(integer) {
+        return !isNaN(Number(integer)) && Number.isInteger(+integer) && +integer > 0;
+    },
+    /**
+     * Validates an array of integers. The integers must be positive (1 or higher).
+     * @param integerString Comma-separated string of integers.
+     * @returns True if the integers are valid, an error message with the invalid integers otherwise.
+     */
+    isValidPositiveIntegerArray(integerString) {
+        const integers = formatting.splitAndTrim(integerString);
+        const invalidIntegers = integers.filter(integer => !this.isValidPositiveInteger(integer));
+        return invalidIntegers.length > 0 ? invalidIntegers.join(', ') : true;
+    },
     isDateInRange(date, monthOffset) {
         const d = new Date(date);
         const cutoffDate = new Date();
@@ -332,6 +351,12 @@ export const validation = {
     isValidISODuration(duration) {
         const durationRegEx = new RegExp(/^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$/);
         return durationRegEx.test(duration);
+    },
+    isValidPermission(permissions) {
+        const invalidPermissions = permissions
+            .split(' ')
+            .filter(permission => permission.indexOf('/') < 0);
+        return invalidPermissions.length > 0 ? invalidPermissions : true;
     }
 };
 //# sourceMappingURL=validation.js.map

package/docs/docs/cmd/external/connection/connection-doctor.mdx

@@ -126,15 +126,15 @@ m365 external connection doctor --id contosoproducts --ux copilot
   <TabItem value="Text">
 
   ```text
-  ✔ Load connection
-  ✔ Load schema
-  ✖ Required semantic labels: Missing label iconUrl
-  ✔ Searchable properties
-  ✔ Items have content ingested
-  ℹ Connection configured for inline results (manual)
-  ℹ Items have activities recorded (manual)
-  ℹ Meaningful connection name and description (manual)
-  ✔ urlToItemResolver configured
+  √ Load connection
+  √ Load schema
+  × Required semantic labels: Missing label iconUrl
+  √ Searchable properties
+  √ Items have content ingested
+  i Connection configured for inline results (manual)
+  i Items have activities recorded (manual)
+  i Meaningful connection name and description (manual)
+  √ urlToItemResolver configured
   ```
 
   </TabItem>