@pnp/cli-microsoft365 10.0.0-beta.e925c1c → 10.0.0-beta.fd332f4

package/dist/m365/teams/commands/team/team-get.js

@@ -5,11 +5,11 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _TeamsTeamGetCommand_instances, _TeamsTeamGetCommand_initTelemetry, _TeamsTeamGetCommand_initOptions, _TeamsTeamGetCommand_initValidators, _TeamsTeamGetCommand_initOptionSets;
 import request from '../../../../request.js';
-import { entraGroup } from '../../../../utils/entraGroup.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
+import { teams } from '../../../../utils/teams.js';
 class TeamsTeamGetCommand extends GraphCommand {
     get name() {
         return commands.TEAM_GET;
@@ -25,28 +25,23 @@ class TeamsTeamGetCommand extends GraphCommand {
         __classPrivateFieldGet(this, _TeamsTeamGetCommand_instances, "m", _TeamsTeamGetCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _TeamsTeamGetCommand_instances, "m", _TeamsTeamGetCommand_initOptionSets).call(this);
     }
-    async getTeamId(args) {
-        if (args.options.id) {
-            return args.options.id;
-        }
-        const group = await entraGroup.getGroupByDisplayName(args.options.name);
-        if (group.resourceProvisioningOptions.indexOf('Team') === -1) {
-            throw 'The specified team does not exist in the Microsoft Teams';
-        }
-        return group.id;
-    }
     async commandAction(logger, args) {
         try {
-            const teamId = await this.getTeamId(args);
-            const requestOptions = {
-                url: `${this.resource}/v1.0/teams/${formatting.encodeQueryParameter(teamId)}`,
-                headers: {
-                    accept: 'application/json;odata.metadata=none'
-                },
-                responseType: 'json'
-            };
-            const res = await request.get(requestOptions);
-            await logger.log(res);
+            let team;
+            if (args.options.id) {
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/teams/${formatting.encodeQueryParameter(args.options.id)}`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json'
+                };
+                team = await request.get(requestOptions);
+            }
+            else {
+                team = await teams.getTeamByDisplayName(args.options.name);
+            }
+            await logger.log(team);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);

package/dist/m365/teams/commands.js

@@ -32,6 +32,7 @@ export default {
     MEETING_LIST: `${prefix} meeting list`,
     MEETING_ATTENDANCEREPORT_GET: `${prefix} meeting attendancereport get`,
     MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
+    MEETING_TRANSCRIPT_GET: `${prefix} meeting transcript get`,
     MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
     MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
     MEMBERSETTINGS_SET: `${prefix} membersettings set`,

package/dist/m365/viva/commands/engage/Community.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Community.js.map

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

@@ -0,0 +1,28 @@
+import { odata } from '../../../../utils/odata.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+class VivaEngageCommunityListCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_LIST;
+    }
+    get description() {
+        return 'Lists all Viva Engage communities';
+    }
+    defaultProperties() {
+        return ['id', 'displayName', 'privacy'];
+    }
+    async commandAction(logger) {
+        if (this.verbose) {
+            await logger.logToStderr('Getting all Viva Engage communities...');
+        }
+        try {
+            const results = await odata.getAllItems(`${this.resource}/v1.0/employeeExperience/communities`);
+            await logger.log(results);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new VivaEngageCommunityListCommand();
+//# sourceMappingURL=engage-community-list.js.map

package/dist/m365/viva/commands.js

@@ -3,6 +3,7 @@ export default {
     CONNECTIONS_APP_CREATE: `${prefix} connections app create`,
     ENGAGE_COMMUNITY_ADD: `${prefix} engage community add`,
     ENGAGE_COMMUNITY_GET: `${prefix} engage community get`,
+    ENGAGE_COMMUNITY_LIST: `${prefix} engage community list`,
     ENGAGE_GROUP_LIST: `${prefix} engage group list`,
     ENGAGE_GROUP_USER_ADD: `${prefix} engage group user add`,
     ENGAGE_GROUP_USER_REMOVE: `${prefix} engage group user remove`,

package/dist/request.js

@@ -4,6 +4,7 @@ import auth, { Auth } from './Auth.js';
 import { app } from './utils/app.js';
 import { formatting } from './utils/formatting.js';
 import { timings } from './cli/timings.js';
+import { timersUtil } from './utils/timersUtil.js';
 class Request {
     set debug(debug) {
         // if the value to set is the same as current value return early to avoid
@@ -125,76 +126,60 @@ class Request {
         options.method = 'HEAD';
         return this.execute(options);
     }
-    execute(options, resolve, reject) {
+    async execute(options) {
         const start = process.hrtime.bigint();
         if (!this._logger) {
-            return Promise.reject('Logger not set on the request object');
+            throw 'Logger not set on the request object';
         }
         this.updateRequestForCloudType(options, auth.connection.cloudType);
-        return new Promise((_resolve, _reject) => {
-            (() => {
-                if (options.headers && options.headers['x-anonymous']) {
-                    return Promise.resolve('');
-                }
-                else {
-                    const url = options.headers && options.headers['x-resource'] ? options.headers['x-resource'] : options.url;
-                    const resource = Auth.getResourceFromUrl(url);
-                    return auth.ensureAccessToken(resource, this._logger, this._debug);
-                }
-            })()
-                .then((accessToken) => {
-                if (options.headers) {
-                    if (options.headers['x-anonymous']) {
-                        delete options.headers['x-anonymous'];
-                    }
-                    if (options.headers['x-resource']) {
-                        delete options.headers['x-resource'];
-                    }
-                    if (accessToken !== '') {
-                        options.headers.authorization = `Bearer ${accessToken}`;
-                    }
-                }
-                const proxyUrl = process.env.HTTP_PROXY || process.env.HTTPS_PROXY;
-                if (proxyUrl) {
-                    options.proxy = this.createProxyConfigFromUrl(proxyUrl);
+        try {
+            let accessToken = '';
+            if (options.headers && options.headers['x-anonymous']) {
+                accessToken = '';
+            }
+            else {
+                const url = options.headers && options.headers['x-resource'] ? options.headers['x-resource'] : options.url;
+                const resource = Auth.getResourceFromUrl(url);
+                accessToken = await auth.ensureAccessToken(resource, this._logger, this._debug);
+            }
+            if (options.headers) {
+                if (options.headers['x-anonymous']) {
+                    delete options.headers['x-anonymous'];
                 }
-                return this.req(options);
-            })
-                .then((res) => {
-                if (resolve) {
-                    resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
+                if (options.headers['x-resource']) {
+                    delete options.headers['x-resource'];
                 }
-                else {
-                    const end = process.hrtime.bigint();
-                    timings.api.push(Number(end - start));
-                    _resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
+                if (accessToken !== '') {
+                    options.headers.authorization = `Bearer ${accessToken}`;
                 }
-            }, async (error) => {
-                if (error && error.response &&
-                    (error.response.status === 429 ||
-                        error.response.status === 503)) {
-                    let retryAfter = parseInt(error.response.headers['retry-after'] || '10');
-                    if (isNaN(retryAfter)) {
-                        retryAfter = 10;
-                    }
-                    if (this._debug) {
-                        await this._logger.log(`Request throttled. Waiting ${retryAfter}sec before retrying...`);
-                    }
-                    // eslint-disable-next-line @typescript-eslint/no-floating-promises
-                    setTimeout(async () => { this.execute(options, resolve || _resolve, reject || _reject); }, retryAfter * 1000);
+            }
+            const proxyUrl = process.env.HTTP_PROXY || process.env.HTTPS_PROXY;
+            if (proxyUrl) {
+                options.proxy = this.createProxyConfigFromUrl(proxyUrl);
+            }
+            const res = await this.req(options);
+            const end = process.hrtime.bigint();
+            timings.api.push(Number(end - start));
+            return options.responseType === 'stream' || options.fullResponse ?
+                res :
+                res.data;
+        }
+        catch (error) {
+            const end = process.hrtime.bigint();
+            timings.api.push(Number(end - start));
+            if (error && error.response && (error.response.status === 429 || error.response.status === 503)) {
+                let retryAfter = parseInt(error.response.headers['retry-after'] || '10');
+                if (isNaN(retryAfter)) {
+                    retryAfter = 10;
                 }
-                else {
-                    if (reject) {
-                        reject(error);
-                    }
-                    else {
-                        const end = process.hrtime.bigint();
-                        timings.api.push(Number(end - start));
-                        _reject(error);
-                    }
+                if (this._debug) {
+                    await this._logger.log(`Request throttled. Waiting ${retryAfter} sec before retrying...`);
                 }
-            });
-        });
+                await timersUtil.setTimeout(retryAfter * 1000);
+                return this.execute(options);
+            }
+            throw error;
+        }
     }
     updateRequestForCloudType(options, cloudType) {
         const url = new URL(options.url);

package/dist/settingsNames.js

@@ -21,7 +21,6 @@ const settingsNames = {
     prompt: 'prompt',
     promptListPageSize: 'promptListPageSize',
     showHelpOnFailure: 'showHelpOnFailure',
-    showSpinner: 'showSpinner',
     tenantId: 'tenantId'
 };
 export { settingsNames };

package/dist/telemetryRunner.js

@@ -8,7 +8,7 @@ try {
     const data = JSON.parse(input);
     const { commandName, properties, exception, shell, session } = data;
     appInsights.commonProperties.shell = shell;
-    appInsights.context.tags['ai.session.id'] = session;
+    appInsights.context.tags[appInsights.context.keys.sessionId] = session;
     if (exception) {
         appInsights.trackException({
             exception
@@ -20,7 +20,7 @@ try {
             properties
         });
     }
-    appInsights.flush();
+    await appInsights.flush();
 }
 catch { }
 //# sourceMappingURL=telemetryRunner.js.map

package/dist/utils/spo.js

@@ -11,17 +11,20 @@ import { odata } from './odata.js';
 import { RoleType } from '../m365/spo/commands/roledefinition/RoleType.js';
 import { entraGroup } from './entraGroup.js';
 import { SharingCapabilities } from '../m365/spo/commands/site/SharingCapabilities.js';
-import { setTimeout } from 'timers/promises';
-export var CreateCopyJobsNameConflictBehavior;
-(function (CreateCopyJobsNameConflictBehavior) {
-    CreateCopyJobsNameConflictBehavior[CreateCopyJobsNameConflictBehavior["Fail"] = 0] = "Fail";
-    CreateCopyJobsNameConflictBehavior[CreateCopyJobsNameConflictBehavior["Replace"] = 1] = "Replace";
-    CreateCopyJobsNameConflictBehavior[CreateCopyJobsNameConflictBehavior["Rename"] = 2] = "Rename";
-})(CreateCopyJobsNameConflictBehavior || (CreateCopyJobsNameConflictBehavior = {}));
+import { timersUtil } from './timersUtil.js';
+export var CreateFileCopyJobsNameConflictBehavior;
+(function (CreateFileCopyJobsNameConflictBehavior) {
+    CreateFileCopyJobsNameConflictBehavior[CreateFileCopyJobsNameConflictBehavior["Fail"] = 0] = "Fail";
+    CreateFileCopyJobsNameConflictBehavior[CreateFileCopyJobsNameConflictBehavior["Replace"] = 1] = "Replace";
+    CreateFileCopyJobsNameConflictBehavior[CreateFileCopyJobsNameConflictBehavior["Rename"] = 2] = "Rename";
+})(CreateFileCopyJobsNameConflictBehavior || (CreateFileCopyJobsNameConflictBehavior = {}));
+export var CreateFolderCopyJobsNameConflictBehavior;
+(function (CreateFolderCopyJobsNameConflictBehavior) {
+    CreateFolderCopyJobsNameConflictBehavior[CreateFolderCopyJobsNameConflictBehavior["Fail"] = 0] = "Fail";
+    CreateFolderCopyJobsNameConflictBehavior[CreateFolderCopyJobsNameConflictBehavior["Rename"] = 2] = "Rename";
+})(CreateFolderCopyJobsNameConflictBehavior || (CreateFolderCopyJobsNameConflictBehavior = {}));
 // Wrapping this into a settings object so we can alter the values in tests
-export const settings = {
-    pollingInterval: 3000
-};
+const pollingInterval = 3000;
 export const spo = {
     async getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -79,7 +82,7 @@ export const spo = {
                 }
                 return;
             }
-            await setTimeout(operation.PollingInterval);
+            await timersUtil.setTimeout(pollingInterval);
             await spo.waitUntilFinished({
                 operationId: JSON.stringify(operation._ObjectIdentity_),
                 siteUrl,
@@ -500,10 +503,10 @@ export const spo = {
    * @param webUrl Web url
    * @param email The email of the user
    * @param logger the Logger object
-   * @param verbose set if verbose logging should be logged
+   * @param verbose set for verbose logging
    */
     async getUserByEmail(webUrl, email, logger, verbose) {
-        if (verbose) {
+        if (verbose && logger) {
             await logger.logToStderr(`Retrieving the spo user by email ${email}`);
         }
         const requestUrl = `${webUrl}/_api/web/siteusers/GetByEmail('${formatting.encodeQueryParameter(email)}')`;
@@ -574,10 +577,10 @@ export const spo = {
     * @param webUrl Web url
     * @param name The name of the group
     * @param logger the Logger object
-    * @param verbose set if verbose logging should be logged
+    * @param verbose set for verbose logging
     */
     async getGroupByName(webUrl, name, logger, verbose) {
-        if (verbose) {
+        if (verbose && logger) {
             await logger.logToStderr(`Retrieving the group by name ${name}`);
         }
         const requestUrl = `${webUrl}/_api/web/sitegroups/GetByName('${formatting.encodeQueryParameter(name)}')`;
@@ -596,10 +599,10 @@ export const spo = {
     * @param webUrl Web url
     * @param name the name of the role definition
     * @param logger the Logger object
-    * @param debug set if debug logging should be logged
+    * @param verbose set for verbose logging
     */
-    async getRoleDefinitionByName(webUrl, name, logger, debug) {
-        if (debug) {
+    async getRoleDefinitionByName(webUrl, name, logger, verbose) {
+        if (verbose && logger) {
             await logger.logToStderr(`Retrieving the role definitions for ${name}`);
         }
         const roledefinitions = await odata.getAllItems(`${webUrl}/_api/web/roledefinitions`);
@@ -691,7 +694,7 @@ export const spo = {
                 if (!wait || isComplete) {
                     return;
                 }
-                await setTimeout(operation.PollingInterval);
+                await timersUtil.setTimeout(pollingInterval);
                 await spo.waitUntilFinished({
                     operationId: JSON.stringify(operation._ObjectIdentity_),
                     siteUrl: spoAdminUrl,
@@ -905,7 +908,7 @@ export const spo = {
         if (!wait || isComplete) {
             return;
         }
-        await setTimeout(operation.PollingInterval);
+        await timersUtil.setTimeout(pollingInterval);
         await spo.waitUntilFinished({
             operationId: JSON.stringify(operation._ObjectIdentity_),
             siteUrl: spoAdminUrl,
@@ -1051,7 +1054,7 @@ export const spo = {
                 const operation = json[json.length - 1];
                 const isComplete = operation.IsComplete;
                 if (!isComplete) {
-                    await setTimeout(operation.PollingInterval);
+                    await timersUtil.setTimeout(pollingInterval);
                     await spo.waitUntilFinished({
                         operationId: JSON.stringify(operation._ObjectIdentity_),
                         siteUrl: spoAdminUrl,
@@ -1528,14 +1531,37 @@ export const spo = {
         return (itemsResponse);
     },
     /**
-     * Create a SharePoint copy job to copy a file/folder to another location.
-     * @param webUrl Absolute web URL where the source file/folder is located.
-     * @param sourceUrl Absolute URL of the source file/folder.
+    * Retrieves the file by id.
+    * Returns a FileProperties object
+    * @param webUrl Web url
+    * @param id the id of the file
+    * @param logger the Logger object
+    * @param verbose set for verbose logging
+    */
+    async getFileById(webUrl, id, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Retrieving the file with id ${id}`);
+        }
+        const requestUrl = `${webUrl}/_api/web/GetFileById('${formatting.encodeQueryParameter(id)}')`;
+        const requestOptions = {
+            url: requestUrl,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const file = await request.get(requestOptions);
+        return file;
+    },
+    /**
+     * Create a SharePoint copy job to copy a file to another location.
+     * @param webUrl Absolute web URL where the source file is located.
+     * @param sourceUrl Absolute URL of the source file.
      * @param destinationUrl Absolute URL of the destination folder.
      * @param options Options for the copy job.
      * @returns Copy job information. Use {@link spo.getCopyJobResult} to get the result of the copy job.
      */
-    async createCopyJob(webUrl, sourceUrl, destinationUrl, options) {
+    async createFileCopyJob(webUrl, sourceUrl, destinationUrl, options) {
         const requestOptions = {
             url: `${webUrl}/_api/Site/CreateCopyJobs`,
             headers: {
@@ -1546,12 +1572,44 @@ export const spo = {
                 destinationUri: destinationUrl,
                 exportObjectUris: [sourceUrl],
                 options: {
-                    NameConflictBehavior: options?.nameConflictBehavior ?? CreateCopyJobsNameConflictBehavior.Fail,
+                    NameConflictBehavior: options?.nameConflictBehavior ?? CreateFileCopyJobsNameConflictBehavior.Fail,
                     AllowSchemaMismatch: true,
                     BypassSharedLock: !!options?.bypassSharedLock,
                     IgnoreVersionHistory: !!options?.ignoreVersionHistory,
+                    IncludeItemPermissions: !!options?.includeItemPermissions,
                     CustomizedItemName: options?.newName ? [options.newName] : undefined,
-                    SameWebCopyMoveOptimization: true
+                    SameWebCopyMoveOptimization: true,
+                    IsMoveMode: options?.operation === 'move'
+                }
+            }
+        };
+        const response = await request.post(requestOptions);
+        return response.value[0];
+    },
+    /**
+     * Create a SharePoint copy job to copy a folder to another location.
+     * @param webUrl Absolute web URL where the source folder is located.
+     * @param sourceUrl Absolute URL of the source folder.
+     * @param destinationUrl Absolute URL of the destination folder.
+     * @param options Options for the copy job.
+     * @returns Copy job information. Use {@link spo.getCopyJobResult} to get the result of the copy job.
+     */
+    async createFolderCopyJob(webUrl, sourceUrl, destinationUrl, options) {
+        const requestOptions = {
+            url: `${webUrl}/_api/Site/CreateCopyJobs`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json',
+            data: {
+                destinationUri: destinationUrl,
+                exportObjectUris: [sourceUrl],
+                options: {
+                    NameConflictBehavior: options?.nameConflictBehavior ?? CreateFolderCopyJobsNameConflictBehavior.Fail,
+                    AllowSchemaMismatch: true,
+                    CustomizedItemName: options?.newName ? [options.newName] : undefined,
+                    SameWebCopyMoveOptimization: true,
+                    IsMoveMode: options?.operation === 'move'
                 }
             }
         };
@@ -1576,12 +1634,20 @@ export const spo = {
                 copyJobInfo: copyJobInfo
             }
         };
+        const logs = [];
         let progress = await request.post(requestOptions);
+        const newLogs = progress.Logs?.map(l => JSON.parse(l));
+        if (newLogs?.length > 0) {
+            logs.push(...newLogs);
+        }
         while (progress.JobState !== 0) {
-            await setTimeout(settings.pollingInterval);
+            await timersUtil.setTimeout(pollingInterval);
             progress = await request.post(requestOptions);
+            const newLogs = progress.Logs?.map(l => JSON.parse(l));
+            if (newLogs?.length > 0) {
+                logs.push(...newLogs);
+            }
         }
-        const logs = progress.Logs.map(l => JSON.parse(l));
         // Check if the job has failed
         const errorLog = logs.find(l => l.Event === 'JobError');
         if (errorLog) {
@@ -1590,6 +1656,77 @@ export const spo = {
         // Get the destination object information
         const objectInfo = logs.find(l => l.Event === 'JobFinishedObjectInfo');
         return objectInfo;
+    },
+    /**
+     * Gets the primary owner login from a site as admin.
+     * @param adminUrl The SharePoint admin URL
+     * @param siteId The site ID
+     * @param logger The logger object
+     * @param verbose If in verbose mode
+     * @returns Owner login name
+     */
+    async getPrimaryAdminLoginNameAsAdmin(adminUrl, siteId, logger, verbose) {
+        if (verbose) {
+            await logger.logToStderr('Getting the primary admin login name...');
+        }
+        const requestOptions = {
+            url: `${adminUrl}/_api/SPO.Tenant/sites('${siteId}')?$select=OwnerLoginName`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const response = await request.get(requestOptions);
+        return response.OwnerLoginName;
+    },
+    /**
+     * Gets the primary owner login from a site.
+     * @param siteUrl The site URL
+     * @param logger The logger object
+     * @param verbose If in verbose mode
+     * @returns Owner login name
+     */
+    async getPrimaryOwnerLoginFromSite(siteUrl, logger, verbose) {
+        if (verbose) {
+            await logger.logToStderr('Getting the primary admin login name...');
+        }
+        const requestOptions = {
+            url: `${siteUrl}/_api/site/owner`,
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const responseContent = await request.get(requestOptions);
+        return responseContent?.LoginName;
+    },
+    /**
+    * Retrieves the site admin properties for a given site URL.
+    * @param adminUrl The SharePoint admin url.
+    * @param siteUrl URL of the site for which to retrieve properties.
+    * @param includeDetail Set to true to include detailed properties.
+    * @param logger The logger object.
+    * @param verbose Set for verbose logging.
+    * @returns Tenant Site properties.
+    */
+    async getSiteAdminPropertiesByUrl(siteUrl, includeDetail, logger, verbose) {
+        if (verbose) {
+            await logger.logToStderr(`Getting site admin properties for URL: ${siteUrl}...`);
+        }
+        const adminUrl = await spo.getSpoAdminUrl(logger, !!verbose);
+        const requestOptions = {
+            url: `${adminUrl}/_api/SPO.Tenant/GetSitePropertiesByUrl`,
+            headers: {
+                accept: 'application/json;odata=nometadata',
+                'content-type': 'application/json;charset=utf-8'
+            },
+            data: {
+                url: siteUrl,
+                includeDetail: includeDetail
+            },
+            responseType: 'json'
+        };
+        return request.post(requestOptions);
     }
 };
 //# sourceMappingURL=spo.js.map

package/dist/utils/spp.js

@@ -0,0 +1,22 @@
+import request from '../request.js';
+export const spp = {
+    /**
+     * Asserts whether the specified site is a content center.
+     * @param siteUrl The URL of the site to check.
+     * @throws Error when the site is not a content center.
+     */
+    async assertSiteIsContentCenter(siteUrl) {
+        const requestOptions = {
+            url: `${siteUrl}/_api/web?$select=WebTemplateConfiguration`,
+            headers: {
+                accept: 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        const response = await request.get(requestOptions);
+        if (response.WebTemplateConfiguration !== 'CONTENTCTR#0') {
+            throw Error(`${siteUrl} is not a content site.`);
+        }
+    }
+};
+//# sourceMappingURL=spp.js.map

package/dist/utils/teams.js

@@ -3,6 +3,25 @@ import { odata } from './odata.js';
 import { cli } from '../cli/cli.js';
 const graphResource = 'https://graph.microsoft.com';
 export const teams = {
+    /**
+     * Retrieve a team by its name.
+     * @param displayName Name of the team to retrieve.
+     * @throws Error if the team cannot be found.
+     * @throws Error when multiple teams with the same name and prompting is disabled.
+     * @returns The Teams team.
+     */
+    async getTeamByDisplayName(displayName) {
+        const teams = await odata.getAllItems(`${graphResource}/v1.0/teams?$filter=displayName eq '${formatting.encodeQueryParameter(displayName)}'`);
+        if (!teams.length) {
+            throw Error(`The specified team '${displayName}' does not exist.`);
+        }
+        if (teams.length === 1) {
+            return teams[0];
+        }
+        const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', teams);
+        const result = await cli.handleMultipleResultsFound(`Multiple teams with name '${displayName}' found.`, resultAsKeyValuePair);
+        return result;
+    },
     /**
      * Retrieve the id of a team by its name.
      * @param displayName Name of the team to retrieve.
@@ -15,12 +34,35 @@ export const teams = {
         if (!teams.length) {
             throw Error(`The specified team '${displayName}' does not exist.`);
         }
-        if (teams.length > 1) {
-            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', teams);
-            const result = await cli.handleMultipleResultsFound(`Multiple teams with name '${displayName}' found.`, resultAsKeyValuePair);
-            return result.id;
+        if (teams.length === 1) {
+            return teams[0].id;
+        }
+        const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', teams);
+        const result = await cli.handleMultipleResultsFound(`Multiple teams with name '${displayName}' found.`, resultAsKeyValuePair);
+        return result.id;
+    },
+    /**
+       * Retrieves a channel by its name in a Microsoft Teams team.
+       * @param teamId The ID of the team.
+       * @param name The name of the channel.
+       * @throws Throws an error if the specified channel does not exist in the team.
+       * @returns The Teams channel.
+       */
+    async getChannelByDisplayName(teamId, name) {
+        const channelRequestOptions = {
+            url: `${graphResource}/v1.0/teams/${teamId}/channels?$filter=displayName eq '${formatting.encodeQueryParameter(name)}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const response = await odata.getAllItems(channelRequestOptions);
+        // Only one channel can have the same name in a team
+        const channelItem = response[0];
+        if (!channelItem) {
+            throw Error(`The channel '${name}' does not exist in the Microsoft Teams team with ID '${teamId}'.`);
         }
-        return teams[0].id;
+        return channelItem;
     },
     /**
      * Retrieves the channel ID by its name in a Microsoft Teams team.