@pnp/cli-microsoft365 10.0.0-beta.48e9f7d → 10.0.0-beta.787c5f1

package/dist/m365/entra/commands/app/app-add.js

@@ -9,10 +9,10 @@ import { v4 } from 'uuid';
 import auth from '../../../../Auth.js';
 import request from '../../../../request.js';
 import { accessToken } from '../../../../utils/accessToken.js';
-import { odata } from '../../../../utils/odata.js';
+import { entraApp } from '../../../../utils/entraApp.js';
 import GraphCommand from '../../../base/GraphCommand.js';
-import commands from '../../commands.js';
 import aadCommands from '../../aadCommands.js';
+import commands from '../../commands.js';
 class EntraAppAddCommand extends GraphCommand {
     get name() {
         return commands.APP_ADD;
@@ -27,7 +27,6 @@ class EntraAppAddCommand extends GraphCommand {
         super();
         _EntraAppAddCommand_instances.add(this);
         this.appName = '';
-        this.appPermissions = [];
         __classPrivateFieldGet(this, _EntraAppAddCommand_instances, "m", _EntraAppAddCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _EntraAppAddCommand_instances, "m", _EntraAppAddCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _EntraAppAddCommand_instances, "m", _EntraAppAddCommand_initValidators).call(this);
@@ -35,16 +34,38 @@ class EntraAppAddCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         await this.showDeprecationWarning(logger, aadCommands.APP_ADD, commands.APP_ADD);
+        if (!args.options.name && this.manifest) {
+            args.options.name = this.manifest.name;
+        }
+        this.appName = args.options.name;
         try {
-            const apis = await this.resolveApis(args, logger);
-            let appInfo = await this.createAppRegistration(args, apis, logger);
+            const apis = await entraApp.resolveApis({
+                options: args.options,
+                manifest: this.manifest,
+                logger,
+                verbose: this.verbose,
+                debug: this.debug
+            });
+            let appInfo = await entraApp.createAppRegistration({
+                options: args.options,
+                apis,
+                logger,
+                verbose: this.verbose,
+                debug: this.debug
+            });
             // based on the assumption that we're adding Microsoft Entra app to the current
             // directory. If we in the future extend the command with allowing
             // users to create Microsoft Entra app in a different directory, we'll need to
             // adjust this
             appInfo.tenantId = accessToken.getTenantIdFromAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
             appInfo = await this.updateAppFromManifest(args, appInfo);
-            appInfo = await this.grantAdminConsent(appInfo, args.options.grantAdminConsent, logger);
+            appInfo = await entraApp.grantAdminConsent({
+                appInfo,
+                appPermissions: entraApp.appPermissions,
+                adminConsent: args.options.grantAdminConsent,
+                logger,
+                debug: this.debug
+            });
             appInfo = await this.configureUri(args, appInfo, logger);
             appInfo = await this.configureSecret(args, appInfo, logger);
             const _appInfo = await this.saveAppInfo(args, appInfo, logger);
@@ -62,128 +83,45 @@ class EntraAppAddCommand extends GraphCommand {
             this.handleRejectedODataJsonPromise(err);
         }
     }
-    async createAppRegistration(args, apis, logger) {
-        const applicationInfo = {
-            displayName: args.options.name,
-            signInAudience: args.options.multitenant ? 'AzureADMultipleOrgs' : 'AzureADMyOrg'
-        };
-        if (!applicationInfo.displayName && this.manifest) {
-            applicationInfo.displayName = this.manifest.name;
-        }
-        this.appName = applicationInfo.displayName;
-        if (apis.length > 0) {
-            applicationInfo.requiredResourceAccess = apis;
-        }
-        if (args.options.redirectUris) {
-            applicationInfo[args.options.platform] = {
-                redirectUris: args.options.redirectUris.split(',').map(u => u.trim())
-            };
-        }
-        if (args.options.implicitFlow) {
-            if (!applicationInfo.web) {
-                applicationInfo.web = {};
-            }
-            applicationInfo.web.implicitGrantSettings = {
-                enableAccessTokenIssuance: true,
-                enableIdTokenIssuance: true
-            };
-        }
-        if (args.options.certificateFile || args.options.certificateBase64Encoded) {
-            const certificateBase64Encoded = await this.getCertificateBase64Encoded(args, logger);
-            const newKeyCredential = {
-                type: "AsymmetricX509Cert",
-                usage: "Verify",
-                displayName: args.options.certificateDisplayName,
-                key: certificateBase64Encoded
-            };
-            applicationInfo.keyCredentials = [newKeyCredential];
-        }
-        if (args.options.allowPublicClientFlows) {
-            applicationInfo.isFallbackPublicClient = true;
+    async configureSecret(args, appInfo, logger) {
+        if (!args.options.withSecret || (appInfo.secrets && appInfo.secrets.length > 0)) {
+            return appInfo;
         }
         if (this.verbose) {
-            await logger.logToStderr(`Creating Microsoft Entra app registration...`);
-        }
-        const createApplicationRequestOptions = {
-            url: `${this.resource}/v1.0/myorganization/applications`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json',
-            data: applicationInfo
-        };
-        return request.post(createApplicationRequestOptions);
-    }
-    async grantAdminConsent(appInfo, adminConsent, logger) {
-        if (!adminConsent || this.appPermissions.length === 0) {
-            return appInfo;
+            await logger.logToStderr(`Configure Microsoft Entra app secret...`);
         }
-        const sp = await this.createServicePrincipal(appInfo.appId);
-        if (this.debug) {
-            await logger.logToStderr("Service principal created, returned object id: " + sp.id);
+        const secret = await this.createSecret({ appObjectId: appInfo.id });
+        if (!appInfo.secrets) {
+            appInfo.secrets = [];
         }
-        const tasks = [];
-        this.appPermissions.forEach(async (permission) => {
-            if (permission.scope.length > 0) {
-                tasks.push(this.grantOAuth2Permission(sp.id, permission.resourceId, permission.scope.join(' ')));
-                if (this.debug) {
-                    await logger.logToStderr(`Admin consent granted for following resource ${permission.resourceId}, with delegated permissions: ${permission.scope.join(',')}`);
-                }
-            }
-            permission.resourceAccess.filter(access => access.type === "Role").forEach(async (access) => {
-                tasks.push(this.addRoleToServicePrincipal(sp.id, permission.resourceId, access.id));
-                if (this.debug) {
-                    await logger.logToStderr(`Admin consent granted for following resource ${permission.resourceId}, with application permission: ${access.id}`);
-                }
-            });
-        });
-        await Promise.all(tasks);
+        appInfo.secrets.push(secret);
         return appInfo;
     }
-    async addRoleToServicePrincipal(objectId, resourceId, appRoleId) {
+    async createSecret({ appObjectId, displayName = undefined, expirationDate = undefined }) {
+        let secretExpirationDate = expirationDate;
+        if (!secretExpirationDate) {
+            secretExpirationDate = new Date();
+            secretExpirationDate.setFullYear(secretExpirationDate.getFullYear() + 1);
+        }
+        const secretName = displayName ?? 'Default';
         const requestOptions = {
-            url: `${this.resource}/v1.0/myorganization/servicePrincipals/${objectId}/appRoleAssignments`,
-            headers: {
-                'Content-Type': 'application/json'
-            },
-            responseType: 'json',
-            data: {
-                appRoleId: appRoleId,
-                principalId: objectId,
-                resourceId: resourceId
-            }
-        };
-        return request.post(requestOptions);
-    }
-    async grantOAuth2Permission(appId, resourceId, scopeName) {
-        const grantAdminConsentApplicationRequestOptions = {
-            url: `${this.resource}/v1.0/myorganization/oauth2PermissionGrants`,
+            url: `${this.resource}/v1.0/myorganization/applications/${appObjectId}/addPassword`,
             headers: {
-                accept: 'application/json;odata.metadata=none'
+                'content-type': 'application/json'
             },
             responseType: 'json',
             data: {
-                clientId: appId,
-                consentType: "AllPrincipals",
-                principalId: null,
-                resourceId: resourceId,
-                scope: scopeName
+                passwordCredential: {
+                    displayName: secretName,
+                    endDateTime: secretExpirationDate.toISOString()
+                }
             }
         };
-        return request.post(grantAdminConsentApplicationRequestOptions);
-    }
-    async createServicePrincipal(appId) {
-        const requestOptions = {
-            url: `${this.resource}/v1.0/myorganization/servicePrincipals`,
-            headers: {
-                'content-type': 'application/json'
-            },
-            data: {
-                appId: appId
-            },
-            responseType: 'json'
+        const response = await request.post(requestOptions);
+        return {
+            displayName: secretName,
+            value: response.secretText
         };
-        return request.post(requestOptions);
     }
     async updateAppFromManifest(args, appInfo) {
         if (!args.options.manifest) {
@@ -423,180 +361,6 @@ class EntraAppAddCommand extends GraphCommand {
         await request.patch(requestOptions);
         return appInfo;
     }
-    async resolveApis(args, logger) {
-        if (!args.options.apisDelegated && !args.options.apisApplication
-            && (typeof this.manifest?.requiredResourceAccess === 'undefined' || this.manifest.requiredResourceAccess.length === 0)) {
-            return [];
-        }
-        if (this.verbose) {
-            await logger.logToStderr('Resolving requested APIs...');
-        }
-        const servicePrincipals = await odata.getAllItems(`${this.resource}/v1.0/myorganization/servicePrincipals?$select=appId,appRoles,id,oauth2PermissionScopes,servicePrincipalNames`);
-        let resolvedApis = [];
-        try {
-            if (args.options.apisDelegated || args.options.apisApplication) {
-                resolvedApis = await this.getRequiredResourceAccessForApis(servicePrincipals, args.options.apisDelegated, 'Scope', logger);
-                if (this.verbose) {
-                    await logger.logToStderr(`Resolved delegated permissions: ${JSON.stringify(resolvedApis, null, 2)}`);
-                }
-                const resolvedApplicationApis = await this.getRequiredResourceAccessForApis(servicePrincipals, args.options.apisApplication, 'Role', logger);
-                if (this.verbose) {
-                    await logger.logToStderr(`Resolved application permissions: ${JSON.stringify(resolvedApplicationApis, null, 2)}`);
-                }
-                // merge resolved application APIs onto resolved delegated APIs
-                resolvedApplicationApis.forEach(resolvedRequiredResource => {
-                    const requiredResource = resolvedApis.find(api => api.resourceAppId === resolvedRequiredResource.resourceAppId);
-                    if (requiredResource) {
-                        requiredResource.resourceAccess.push(...resolvedRequiredResource.resourceAccess);
-                    }
-                    else {
-                        resolvedApis.push(resolvedRequiredResource);
-                    }
-                });
-            }
-            else {
-                const manifestApis = this.manifest.requiredResourceAccess;
-                manifestApis.forEach(manifestApi => {
-                    resolvedApis.push(manifestApi);
-                    const app = servicePrincipals.find(servicePrincipals => servicePrincipals.appId === manifestApi.resourceAppId);
-                    if (app) {
-                        manifestApi.resourceAccess.forEach((res => {
-                            const resourceAccessPermission = {
-                                id: res.id,
-                                type: res.type
-                            };
-                            const oAuthValue = app.oauth2PermissionScopes.find(scp => scp.id === res.id)?.value;
-                            this.updateAppPermissions(app.id, resourceAccessPermission, oAuthValue);
-                        }));
-                    }
-                });
-            }
-            if (this.verbose) {
-                await logger.logToStderr(`Merged delegated and application permissions: ${JSON.stringify(resolvedApis, null, 2)}`);
-                await logger.logToStderr(`App role assignments: ${JSON.stringify(this.appPermissions.flatMap(permission => permission.resourceAccess.filter(access => access.type === "Role")), null, 2)}`);
-                await logger.logToStderr(`OAuth2 permissions: ${JSON.stringify(this.appPermissions.flatMap(permission => permission.scope), null, 2)}`);
-            }
-            return resolvedApis;
-        }
-        catch (e) {
-            throw e;
-        }
-    }
-    async getRequiredResourceAccessForApis(servicePrincipals, apis, scopeType, logger) {
-        if (!apis) {
-            return [];
-        }
-        const resolvedApis = [];
-        const requestedApis = apis.split(',').map(a => a.trim());
-        for (const api of requestedApis) {
-            const pos = api.lastIndexOf('/');
-            const permissionName = api.substr(pos + 1);
-            const servicePrincipalName = api.substr(0, pos);
-            if (this.debug) {
-                await logger.logToStderr(`Resolving ${api}...`);
-                await logger.logToStderr(`Permission name: ${permissionName}`);
-                await logger.logToStderr(`Service principal name: ${servicePrincipalName}`);
-            }
-            const servicePrincipal = servicePrincipals.find(sp => (sp.servicePrincipalNames.indexOf(servicePrincipalName) > -1 ||
-                sp.servicePrincipalNames.indexOf(`${servicePrincipalName}/`) > -1));
-            if (!servicePrincipal) {
-                throw `Service principal ${servicePrincipalName} not found`;
-            }
-            const scopesOfType = scopeType === 'Scope' ? servicePrincipal.oauth2PermissionScopes : servicePrincipal.appRoles;
-            const permission = scopesOfType.find(scope => scope.value === permissionName);
-            if (!permission) {
-                throw `Permission ${permissionName} for service principal ${servicePrincipalName} not found`;
-            }
-            let resolvedApi = resolvedApis.find(a => a.resourceAppId === servicePrincipal.appId);
-            if (!resolvedApi) {
-                resolvedApi = {
-                    resourceAppId: servicePrincipal.appId,
-                    resourceAccess: []
-                };
-                resolvedApis.push(resolvedApi);
-            }
-            const resourceAccessPermission = {
-                id: permission.id,
-                type: scopeType
-            };
-            resolvedApi.resourceAccess.push(resourceAccessPermission);
-            this.updateAppPermissions(servicePrincipal.id, resourceAccessPermission, permission.value);
-        }
-        return resolvedApis;
-    }
-    updateAppPermissions(spId, resourceAccessPermission, oAuth2PermissionValue) {
-        // During API resolution, we store globally both app role assignments and oauth2permissions
-        // So that we'll be able to parse them during the admin consent process
-        let existingPermission = this.appPermissions.find(oauth => oauth.resourceId === spId);
-        if (!existingPermission) {
-            existingPermission = {
-                resourceId: spId,
-                resourceAccess: [],
-                scope: []
-            };
-            this.appPermissions.push(existingPermission);
-        }
-        if (resourceAccessPermission.type === 'Scope' && oAuth2PermissionValue && !existingPermission.scope.find(scp => scp === oAuth2PermissionValue)) {
-            existingPermission.scope.push(oAuth2PermissionValue);
-        }
-        if (!existingPermission.resourceAccess.find(res => res.id === resourceAccessPermission.id)) {
-            existingPermission.resourceAccess.push(resourceAccessPermission);
-        }
-    }
-    async configureSecret(args, appInfo, logger) {
-        if (!args.options.withSecret || (appInfo.secrets && appInfo.secrets.length > 0)) {
-            return appInfo;
-        }
-        if (this.verbose) {
-            await logger.logToStderr(`Configure Microsoft Entra app secret...`);
-        }
-        const secret = await this.createSecret({ appObjectId: appInfo.id });
-        if (!appInfo.secrets) {
-            appInfo.secrets = [];
-        }
-        appInfo.secrets.push(secret);
-        return appInfo;
-    }
-    async createSecret({ appObjectId, displayName = undefined, expirationDate = undefined }) {
-        let secretExpirationDate = expirationDate;
-        if (!secretExpirationDate) {
-            secretExpirationDate = new Date();
-            secretExpirationDate.setFullYear(secretExpirationDate.getFullYear() + 1);
-        }
-        const secretName = displayName ?? 'Default';
-        const requestOptions = {
-            url: `${this.resource}/v1.0/myorganization/applications/${appObjectId}/addPassword`,
-            headers: {
-                'content-type': 'application/json'
-            },
-            responseType: 'json',
-            data: {
-                passwordCredential: {
-                    displayName: secretName,
-                    endDateTime: secretExpirationDate.toISOString()
-                }
-            }
-        };
-        const response = await request.post(requestOptions);
-        return {
-            displayName: secretName,
-            value: response.secretText
-        };
-    }
-    async getCertificateBase64Encoded(args, logger) {
-        if (args.options.certificateBase64Encoded) {
-            return args.options.certificateBase64Encoded;
-        }
-        if (this.debug) {
-            await logger.logToStderr(`Reading existing ${args.options.certificateFile}...`);
-        }
-        try {
-            return fs.readFileSync(args.options.certificateFile, { encoding: 'base64' });
-        }
-        catch (e) {
-            throw new Error(`Error reading certificate file: ${e}. Please add the certificate using base64 option '--certificateBase64Encoded'.`);
-        }
-    }
     async saveAppInfo(args, appInfo, logger) {
         if (!args.options.save) {
             return appInfo;

package/dist/m365/flow/commands/environment/environment-get.js

@@ -28,7 +28,7 @@ class FlowEnvironmentGetCommand extends PowerAutomateCommand {
         if (this.verbose) {
             await logger.logToStderr(`Retrieving information about Microsoft Flow environment ${args.options.name ?? ''}...`);
         }
-        let requestUrl = `${this.resource}/providers/Microsoft.ProcessSimple/environments/`;
+        let requestUrl = `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/environments/`;
         if (args.options.name) {
             requestUrl += `${formatting.encodeQueryParameter(args.options.name)}`;
         }

package/dist/m365/flow/commands/environment/environment-list.js

@@ -16,7 +16,7 @@ class FlowEnvironmentListCommand extends PowerAutomateCommand {
             await logger.logToStderr(`Retrieving list of Microsoft Flow environments...`);
         }
         try {
-            const res = await odata.getAllItems(`${this.resource}/providers/Microsoft.ProcessSimple/environments?api-version=2016-11-01`);
+            const res = await odata.getAllItems(`${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/environments?api-version=2016-11-01`);
             if (res.length > 0) {
                 if (args.options.output !== 'json') {
                     res.forEach(e => {

package/dist/m365/flow/commands/flow-disable.js

@@ -26,7 +26,7 @@ class FlowDisableCommand extends PowerAutomateCommand {
             await logger.logToStderr(`Disables Microsoft Flow ${args.options.name}...`);
         }
         const requestOptions = {
-            url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}/stop?api-version=2016-11-01`,
+            url: `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}/stop?api-version=2016-11-01`,
             headers: {
                 accept: 'application/json'
             },

package/dist/m365/flow/commands/flow-enable.js

@@ -26,7 +26,7 @@ class FlowEnableCommand extends PowerAutomateCommand {
             await logger.logToStderr(`Enables Microsoft Flow ${args.options.name}...`);
         }
         const requestOptions = {
-            url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}/start?api-version=2016-11-01`,
+            url: `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}/start?api-version=2016-11-01`,
             headers: {
                 accept: 'application/json'
             },

package/dist/m365/flow/commands/flow-export.js

@@ -11,6 +11,7 @@ import { formatting } from '../../../utils/formatting.js';
 import { validation } from '../../../utils/validation.js';
 import PowerPlatformCommand from '../../base/PowerPlatformCommand.js';
 import commands from '../commands.js';
+import PowerAutomateCommand from '../../base/PowerAutomateCommand.js';
 class FlowExportCommand extends PowerPlatformCommand {
     get name() {
         return commands.EXPORT;
@@ -27,15 +28,15 @@ class FlowExportCommand extends PowerPlatformCommand {
     }
     async commandAction(logger, args) {
         let filenameFromApi = '';
-        const formatArgument = args.options.format ? args.options.format.toLowerCase() : '';
+        const formatArgument = args.options.format?.toLowerCase() || '';
         if (this.verbose) {
             await logger.logToStderr(`Retrieving package resources for Microsoft Flow ${args.options.name}...`);
         }
         try {
             let res;
             if (formatArgument === 'json') {
-                if (this.debug) {
-                    await logger.logToStderr('format = json, skipping listing package resources step');
+                if (this.verbose) {
+                    await logger.logToStderr('format = json, skipping listing package resources step.');
                 }
             }
             else {
@@ -61,7 +62,7 @@ class FlowExportCommand extends PowerPlatformCommand {
             }
             let requestOptions = {
                 url: formatArgument === 'json' ?
-                    `https://management.azure.com/providers/Microsoft.ProcessSimple/environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01`
+                    `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01`
                     : `${this.resource}/providers/Microsoft.BusinessAppPlatform/environments/${formatting.encodeQueryParameter(args.options.environmentName)}/exportPackage?api-version=2016-11-01`,
                 headers: {
                     accept: 'application/json'
@@ -76,17 +77,17 @@ class FlowExportCommand extends PowerPlatformCommand {
                         ? res.resources[key].suggestedCreationType = 'Update'
                         : res.resources[key].suggestedCreationType = 'Existing';
                 });
-                requestOptions['data'] = {
-                    "includedResourceIds": [
+                requestOptions.data = {
+                    includedResourceIds: [
                         `/providers/Microsoft.Flow/flows/${args.options.name}`
                     ],
-                    "details": {
-                        "displayName": args.options.packageDisplayName,
-                        "description": args.options.packageDescription,
-                        "creator": args.options.packageCreatedBy,
-                        "sourceEnvironment": args.options.packageSourceEnvironment
+                    details: {
+                        displayName: args.options.packageDisplayName,
+                        description: args.options.packageDescription,
+                        creator: args.options.packageCreatedBy,
+                        sourceEnvironment: args.options.packageSourceEnvironment
                     },
-                    "resources": res.resources
+                    resources: res.resources
                 };
             }
             res = formatArgument === 'json' ? await request.get(requestOptions) : await request.post(requestOptions);
@@ -99,13 +100,13 @@ class FlowExportCommand extends PowerPlatformCommand {
             // Replace all illegal characters from the file name
             const illegalCharsRegEx = /[\\\/:*?"<>|]/g;
             filenameFromApi = filenameFromApi.replace(illegalCharsRegEx, '_');
-            if (this.debug) {
-                await logger.logToStderr(`Filename from PowerApps API: ${filenameFromApi}`);
+            if (this.verbose) {
+                await logger.logToStderr(`Filename from PowerApps API: ${filenameFromApi}.`);
                 await logger.logToStderr('');
             }
             requestOptions = {
                 url: formatArgument === 'json' ?
-                    `https://management.azure.com/providers/Microsoft.ProcessSimple/environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}/exportToARMTemplate?api-version=2016-11-01`
+                    `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}/exportToARMTemplate?api-version=2016-11-01`
                     : downloadFileUrl,
                 // Set responseType to arraybuffer, otherwise binary data will be encoded
                 // to utf8 and binary data is corrupt
@@ -124,7 +125,7 @@ class FlowExportCommand extends PowerPlatformCommand {
             fs.writeFileSync(path, file, 'binary');
             if (!args.options.path || this.verbose) {
                 if (this.verbose) {
-                    await logger.logToStderr(`File saved to path '${path}'`);
+                    await logger.logToStderr(`File saved to path '${path}'.`);
                 }
                 else {
                     await logger.log(path);

package/dist/m365/flow/commands/flow-get.js

@@ -29,7 +29,7 @@ class FlowGetCommand extends PowerAutomateCommand {
             await logger.logToStderr(`Retrieving information about Microsoft Flow ${args.options.name}...`);
         }
         const requestOptions = {
-            url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01&$expand=swagger,properties.connectionreferences.apidefinition,properties.definitionsummary.operations.apioperation,operationDefinition,plan,properties.throttleData,properties.estimatedsuspensiondata,properties.licenseData`,
+            url: `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01&$expand=swagger,properties.connectionreferences.apidefinition,properties.definitionsummary.operations.apioperation,operationDefinition,plan,properties.throttleData,properties.estimatedsuspensiondata,properties.licenseData`,
             headers: {
                 accept: 'application/json'
             },

package/dist/m365/flow/commands/flow-list.js

@@ -67,7 +67,7 @@ class FlowListCommand extends PowerAutomateCommand {
         }
     }
     getApiUrl(environmentName, asAdmin, includeSolutionFlows, filter) {
-        const baseEndpoint = `${this.resource}/providers/Microsoft.ProcessSimple`;
+        const baseEndpoint = `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple`;
         const environmentSegment = `/environments/${formatting.encodeQueryParameter(environmentName)}`;
         const adminSegment = `/scopes/admin${environmentSegment}/v2`;
         const flowsEndpoint = '/flows?api-version=2016-11-01';

package/dist/m365/flow/commands/flow-remove.js

@@ -30,7 +30,7 @@ class FlowRemoveCommand extends PowerAutomateCommand {
         }
         const removeFlow = async () => {
             const requestOptions = {
-                url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01`,
+                url: `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.name)}?api-version=2016-11-01`,
                 fullResponse: true,
                 headers: {
                     accept: 'application/json'

package/dist/m365/flow/commands/owner/owner-ensure.js

@@ -52,7 +52,7 @@ class FlowOwnerEnsureCommand extends PowerAutomateCommand {
                 type = 'Group';
             }
             const requestOptions = {
-                url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.flowName)}/modifyPermissions?api-version=2016-11-01`,
+                url: `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.flowName)}/modifyPermissions?api-version=2016-11-01`,
                 headers: {
                     accept: 'application/json'
                 },

package/dist/m365/flow/commands/owner/owner-list.js

@@ -32,7 +32,7 @@ class FlowOwnerListCommand extends PowerAutomateCommand {
             if (this.verbose) {
                 await logger.logToStderr(`Listing owners for flow ${args.options.flowName} in environment ${args.options.environmentName}`);
             }
-            const response = await odata.getAllItems(`${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.flowName)}/permissions?api-version=2016-11-01`);
+            const response = await odata.getAllItems(`${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.flowName)}/permissions?api-version=2016-11-01`);
             if (!cli.shouldTrimOutput(args.options.output)) {
                 await logger.log(response);
             }

package/dist/m365/flow/commands/owner/owner-remove.js

@@ -47,7 +47,7 @@ class FlowOwnerRemoveCommand extends PowerAutomateCommand {
                     idToRemove = await entraGroup.getGroupIdByDisplayName(args.options.groupName);
                 }
                 const requestOptions = {
-                    url: `${this.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.flowName)}/modifyPermissions?api-version=2016-11-01`,
+                    url: `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/${args.options.asAdmin ? 'scopes/admin/' : ''}environments/${formatting.encodeQueryParameter(args.options.environmentName)}/flows/${formatting.encodeQueryParameter(args.options.flowName)}/modifyPermissions?api-version=2016-11-01`,
                     headers: {
                         accept: 'application/json'
                     },

package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-list.js

@@ -0,0 +1,47 @@
+import PowerAutomateCommand from '../../../base/PowerAutomateCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import commands from '../../commands.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { odata } from '../../../../utils/odata.js';
+import { cli } from '../../../../cli/cli.js';
+const options = globalOptionsZod
+    .extend({
+    environmentName: zod.alias('e', z.string())
+})
+    .strict();
+class FlowRecycleBinItemListCommand extends PowerAutomateCommand {
+    get name() {
+        return commands.RECYCLEBINITEM_LIST;
+    }
+    get description() {
+        return 'Lists all soft-deleted Power Automate flows within an environment';
+    }
+    defaultProperties() {
+        return ['name', 'displayName'];
+    }
+    get schema() {
+        return options;
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Getting list of soft-deleted flows in environment ${args.options.environmentName}...`);
+            }
+            const flows = await odata.getAllItems(`${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/scopes/admin/environments/${formatting.encodeQueryParameter(args.options.environmentName)}/v2/flows?api-version=2016-11-01&include=softDeletedFlows`);
+            const deletedFlows = flows.filter(flow => flow.properties.state === 'Deleted');
+            if (cli.shouldTrimOutput(args.options.output)) {
+                deletedFlows.forEach(flow => {
+                    flow.displayName = flow.properties.displayName;
+                });
+            }
+            await logger.log(deletedFlows);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new FlowRecycleBinItemListCommand();
+//# sourceMappingURL=recyclebinitem-list.js.map