@pnp/cli-microsoft365 11.0.0-beta.4be9237 → 11.0.0-beta.88d51e6

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

@@ -425,7 +425,9 @@ _a = EntraAppAddCommand, _EntraAppAddCommand_instances = new WeakSet(), _EntraAp
             certificateBase64Encoded: typeof args.options.certificateBase64Encoded !== 'undefined',
             certificateDisplayName: typeof args.options.certificateDisplayName !== 'undefined',
             grantAdminConsent: typeof args.options.grantAdminConsent !== 'undefined',
-            allowPublicClientFlows: typeof args.options.allowPublicClientFlows !== 'undefined'
+            allowPublicClientFlows: typeof args.options.allowPublicClientFlows !== 'undefined',
+            bundleId: typeof args.options.bundleId !== 'undefined',
+            signatureHash: typeof args.options.signatureHash !== 'undefined'
         });
     });
 }, _EntraAppAddCommand_initOptions = function _EntraAppAddCommand_initOptions() {
@@ -465,6 +467,10 @@ _a = EntraAppAddCommand, _EntraAppAddCommand_instances = new WeakSet(), _EntraAp
         option: '--certificateDisplayName [certificateDisplayName]'
     }, {
         option: '--manifest [manifest]'
+    }, {
+        option: '--bundleId [bundleId]'
+    }, {
+        option: '--signatureHash [signatureHash]'
     }, {
         option: '--save'
     }, {
@@ -519,12 +525,18 @@ _a = EntraAppAddCommand, _EntraAppAddCommand_instances = new WeakSet(), _EntraAp
                 return `Error while parsing the specified manifest: ${e}`;
             }
         }
+        if (args.options.platform === 'apple' && !args.options.bundleId) {
+            return `When you use platform apple, you'll need to specify bundleId`;
+        }
+        if (args.options.platform === 'android' && (!args.options.bundleId || !args.options.signatureHash)) {
+            return `When you use platform android, you'll need to specify bundleId and signatureHash`;
+        }
         return true;
     });
 }, _EntraAppAddCommand_initOptionSets = function _EntraAppAddCommand_initOptionSets() {
     this.optionSets.push({ options: ['name', 'manifest'] });
 };
-EntraAppAddCommand.entraApplicationPlatform = ['spa', 'web', 'publicClient'];
+EntraAppAddCommand.entraApplicationPlatform = ['spa', 'web', 'publicClient', 'apple', 'android'];
 EntraAppAddCommand.entraAppScopeConsentBy = ['admins', 'adminsAndUsers'];
 export default new EntraAppAddCommand();
 //# sourceMappingURL=app-add.js.map

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

@@ -1,13 +1,16 @@
-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 _FlowEnvironmentGetCommand_instances, _FlowEnvironmentGetCommand_initOptions, _FlowEnvironmentGetCommand_initTelemetry;
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { zod } from '../../../../utils/zod.js';
 import PowerAutomateCommand from '../../../base/PowerAutomateCommand.js';
 import commands from '../../commands.js';
+const options = globalOptionsZod
+    .extend({
+    name: zod.alias('n', z.string().optional()),
+    default: z.boolean().optional()
+})
+    .strict();
 class FlowEnvironmentGetCommand extends PowerAutomateCommand {
     get name() {
         return commands.ENVIRONMENT_GET;
@@ -15,23 +18,21 @@ class FlowEnvironmentGetCommand extends PowerAutomateCommand {
     get description() {
         return 'Gets information about the specified Microsoft Flow environment';
     }
-    constructor() {
-        super();
-        _FlowEnvironmentGetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _FlowEnvironmentGetCommand_instances, "m", _FlowEnvironmentGetCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _FlowEnvironmentGetCommand_instances, "m", _FlowEnvironmentGetCommand_initTelemetry).call(this);
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !!options.name !== !!options.default, {
+            message: `Specify either name or default, but not both.`
+        });
     }
     async commandAction(logger, args) {
         if (this.verbose) {
-            await logger.logToStderr(`Retrieving information about Microsoft Flow environment ${args.options.name ?? ''}...`);
+            await logger.logToStderr(`Retrieving information about Microsoft Flow environment ${args.options.name ?? 'default'}...`);
         }
         let requestUrl = `${PowerAutomateCommand.resource}/providers/Microsoft.ProcessSimple/environments/`;
-        if (args.options.name) {
-            requestUrl += `${formatting.encodeQueryParameter(args.options.name)}`;
-        }
-        else {
-            requestUrl += `~default`;
-        }
+        requestUrl += args.options.default ? '~default' : formatting.encodeQueryParameter(args.options.name);
         const requestOptions = {
             url: `${requestUrl}?api-version=2016-11-01`,
             headers: {
@@ -55,16 +56,5 @@ class FlowEnvironmentGetCommand extends PowerAutomateCommand {
         }
     }
 }
-_FlowEnvironmentGetCommand_instances = new WeakSet(), _FlowEnvironmentGetCommand_initOptions = function _FlowEnvironmentGetCommand_initOptions() {
-    this.options.unshift({
-        option: '-n, --name [name]'
-    });
-}, _FlowEnvironmentGetCommand_initTelemetry = function _FlowEnvironmentGetCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            name: typeof args.options.name !== 'undefined'
-        });
-    });
-};
 export default new FlowEnvironmentGetCommand();
 //# sourceMappingURL=environment-get.js.map

package/dist/m365/outlook/commands/mail/mail-searchfolder-add.js

@@ -0,0 +1,85 @@
+import request from '../../../../request.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import { validation } from '../../../../utils/validation.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import auth from '../../../../Auth.js';
+const options = globalOptionsZod
+    .extend({
+    userId: zod.alias('i', z.string()
+        .refine(userId => validation.isValidGuid(userId), userId => ({
+        message: `'${userId}' is not a valid GUID.`
+    })).optional()),
+    userName: zod.alias('n', z.string()
+        .refine(userName => validation.isValidUserPrincipalName(userName), userName => ({
+        message: `'${userName}' is not a valid UPN.`
+    })).optional()),
+    folderName: z.string(),
+    messageFilter: z.string(),
+    sourceFoldersIds: z.string().transform((value) => value.split(',')).pipe(z.string().array()),
+    includeNestedFolders: z.boolean().optional()
+})
+    .strict();
+class OutlookMailSearchFolderAddCommand extends GraphCommand {
+    get name() {
+        return commands.MAIL_SEARCHFOLDER_ADD;
+    }
+    get description() {
+        return `Creates a new mail search folder in the user's mailbox`;
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !(options.userId && options.userName), {
+            message: 'Specify either userId or userName, but not both'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
+            let requestUrl = `${this.resource}/v1.0/me/mailFolders/searchFolders/childFolders`;
+            if (isAppOnlyAccessToken) {
+                if (!args.options.userId && !args.options.userName) {
+                    throw 'When running with application permissions either userId or userName is required';
+                }
+                const userIdentifier = args.options.userId ?? args.options.userName;
+                requestUrl = `${this.resource}/v1.0/users('${userIdentifier}')/mailFolders/searchFolders/childFolders`;
+                if (args.options.verbose) {
+                    await logger.logToStderr(`Creating a mail search folder in the mailbox of the user ${userIdentifier}...`);
+                }
+            }
+            else {
+                if (args.options.userId || args.options.userName) {
+                    throw 'You can create mail search folder for other users only if CLI is authenticated in app-only mode';
+                }
+            }
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json'
+                },
+                responseType: 'json',
+                data: {
+                    '@odata.type': '#microsoft.graph.mailSearchFolder',
+                    displayName: args.options.folderName,
+                    includeNestedFolders: args.options.includeNestedFolders,
+                    filterQuery: args.options.messageFilter,
+                    sourceFolderIds: args.options.sourceFoldersIds
+                }
+            };
+            const result = await request.post(requestOptions);
+            await logger.log(result);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new OutlookMailSearchFolderAddCommand();
+//# sourceMappingURL=mail-searchfolder-add.js.map

package/dist/m365/outlook/commands.js

@@ -1,5 +1,6 @@
 const prefix = 'outlook';
 export default {
+    MAIL_SEARCHFOLDER_ADD: `${prefix} mail searchfolder add`,
     MAIL_SEND: `${prefix} mail send`,
     MAILBOX_SETTINGS_GET: `${prefix} mailbox settings get`,
     MAILBOX_SETTINGS_SET: `${prefix} mailbox settings set`,

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

@@ -1,13 +1,16 @@
-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 _PaEnvironmentGetCommand_instances, _PaEnvironmentGetCommand_initTelemetry, _PaEnvironmentGetCommand_initOptions;
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { zod } from '../../../../utils/zod.js';
 import PowerAppsCommand from '../../../base/PowerAppsCommand.js';
 import commands from '../../commands.js';
+const options = globalOptionsZod
+    .extend({
+    name: zod.alias('n', z.string().optional()),
+    default: z.boolean().optional()
+})
+    .strict();
 class PaEnvironmentGetCommand extends PowerAppsCommand {
     get name() {
         return commands.ENVIRONMENT_GET;
@@ -15,17 +18,20 @@ class PaEnvironmentGetCommand extends PowerAppsCommand {
     get description() {
         return 'Gets information about the specified Microsoft Power Apps environment';
     }
-    constructor() {
-        super();
-        _PaEnvironmentGetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _PaEnvironmentGetCommand_instances, "m", _PaEnvironmentGetCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _PaEnvironmentGetCommand_instances, "m", _PaEnvironmentGetCommand_initOptions).call(this);
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !!options.name !== !!options.default, {
+            message: `Specify either name or default, but not both.`
+        });
     }
     async commandAction(logger, args) {
         if (this.verbose) {
             await logger.logToStderr(`Retrieving information about Microsoft Power Apps environment ${args.options.name || 'default'}...`);
         }
-        const environmentName = args.options.name ? formatting.encodeQueryParameter(args.options.name) : '~default';
+        const environmentName = args.options.default ? '~default' : formatting.encodeQueryParameter(args.options.name);
         const requestOptions = {
             url: `${this.resource}/providers/Microsoft.PowerApps/environments/${environmentName}?api-version=2016-11-01`,
             headers: {
@@ -47,16 +53,5 @@ class PaEnvironmentGetCommand extends PowerAppsCommand {
         }
     }
 }
-_PaEnvironmentGetCommand_instances = new WeakSet(), _PaEnvironmentGetCommand_initTelemetry = function _PaEnvironmentGetCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            name: typeof args.options.name !== 'undefined'
-        });
-    });
-}, _PaEnvironmentGetCommand_initOptions = function _PaEnvironmentGetCommand_initOptions() {
-    this.options.unshift({
-        option: '-n, --name [name]'
-    });
-};
 export default new PaEnvironmentGetCommand();
 //# sourceMappingURL=environment-get.js.map

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

@@ -1,13 +1,17 @@
-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 _PpEnvironmentGetCommand_instances, _PpEnvironmentGetCommand_initTelemetry, _PpEnvironmentGetCommand_initOptions;
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { zod } from '../../../../utils/zod.js';
 import PowerPlatformCommand from '../../../base/PowerPlatformCommand.js';
 import commands from '../../commands.js';
+const options = globalOptionsZod
+    .extend({
+    name: zod.alias('n', z.string().optional()),
+    default: z.boolean().optional(),
+    asAdmin: z.boolean().optional()
+})
+    .strict();
 class PpEnvironmentGetCommand extends PowerPlatformCommand {
     get name() {
         return commands.ENVIRONMENT_GET;
@@ -15,11 +19,14 @@ class PpEnvironmentGetCommand extends PowerPlatformCommand {
     get description() {
         return 'Gets information about the specified Power Platform environment';
     }
-    constructor() {
-        super();
-        _PpEnvironmentGetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _PpEnvironmentGetCommand_instances, "m", _PpEnvironmentGetCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _PpEnvironmentGetCommand_instances, "m", _PpEnvironmentGetCommand_initOptions).call(this);
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !!options.name !== !!options.default, {
+            message: `Specify either name or default, but not both.`
+        });
     }
     async commandAction(logger, args) {
         if (this.verbose) {
@@ -29,7 +36,7 @@ class PpEnvironmentGetCommand extends PowerPlatformCommand {
         if (args.options.asAdmin) {
             url += '/scopes/admin';
         }
-        const envName = args.options.name ? formatting.encodeQueryParameter(args.options.name) : '~Default';
+        const envName = args.options.default ? '~Default' : formatting.encodeQueryParameter(args.options.name);
         url += `/environments/${envName}?api-version=2020-10-01`;
         const requestOptions = {
             url: url,
@@ -42,19 +49,5 @@ class PpEnvironmentGetCommand extends PowerPlatformCommand {
         await logger.log(response);
     }
 }
-_PpEnvironmentGetCommand_instances = new WeakSet(), _PpEnvironmentGetCommand_initTelemetry = function _PpEnvironmentGetCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            name: typeof args.options.name !== 'undefined',
-            asAdmin: !!args.options.asAdmin
-        });
-    });
-}, _PpEnvironmentGetCommand_initOptions = function _PpEnvironmentGetCommand_initOptions() {
-    this.options.unshift({
-        option: '-n, --name [name]'
-    }, {
-        option: '--asAdmin'
-    });
-};
 export default new PpEnvironmentGetCommand();
 //# sourceMappingURL=environment-get.js.map

package/dist/m365/spo/commands/file/file-version-keep.js

@@ -0,0 +1,78 @@
+import commands from '../../commands.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { zod } from '../../../../utils/zod.js';
+import { validation } from '../../../../utils/validation.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+import { odata } from '../../../../utils/odata.js';
+export const options = globalOptionsZod
+    .extend({
+    webUrl: zod.alias('u', z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, url => ({
+        message: `'${url}' is not a valid SharePoint Online site URL.`
+    }))),
+    fileUrl: z.string().optional(),
+    fileId: zod.alias('i', z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional()),
+    label: z.string()
+})
+    .strict();
+class SpoFileVersionKeepCommand extends SpoCommand {
+    get name() {
+        return commands.FILE_VERSION_KEEP;
+    }
+    get description() {
+        return 'Ensure that a specific file version will never expire';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.fileUrl, options.fileId].filter(o => o !== undefined).length === 1, {
+            message: `Specify 'fileUrl' or 'fileId', but not both.`
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr(`Ensuring version '${args.options.label}' of file '${args.options.fileUrl || args.options.fileId}' at site '${args.options.webUrl}' will never expire...`);
+        }
+        try {
+            const baseApiUrl = this.getBaseApiUrl(args.options.webUrl, args.options.fileUrl, args.options.fileId);
+            const response = await odata.getAllItems(`${baseApiUrl}/versions?$filter=VersionLabel eq '${formatting.encodeQueryParameter(args.options.label)}'&$select=ID`);
+            if (response.length === 0) {
+                throw `Version with label '${args.options.label}' not found.`;
+            }
+            const requestExpirationOptions = {
+                url: `${baseApiUrl}/versions(${response[0].ID})/SetExpirationDate()`,
+                headers: {
+                    accept: 'application/json;odata=nometadata',
+                    'content-type': 'application/json'
+                },
+                responseType: 'json'
+            };
+            await request.post(requestExpirationOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    getBaseApiUrl(webUrl, fileUrl, fileId) {
+        let requestUrl;
+        if (fileUrl) {
+            const serverRelUrl = urlUtil.getServerRelativePath(webUrl, fileUrl);
+            requestUrl = `${webUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(serverRelUrl)}')`;
+        }
+        else {
+            requestUrl = `${webUrl}/_api/web/GetFileById('${fileId}')`;
+        }
+        return requestUrl;
+    }
+}
+export default new SpoFileVersionKeepCommand();
+//# sourceMappingURL=file-version-keep.js.map

package/dist/m365/spo/commands/list/list-view-add.js

@@ -114,7 +114,7 @@ class SpoListViewAddCommand extends SpoCommand {
                         Query: args.options.viewQuery,
                         PersonalView: !!args.options.personal,
                         SetAsDefaultView: !!args.options.default,
-                        Paged: !!args.options.paged,
+                        Paged: args.options.paged ?? true,
                         RowLimit: args.options.rowLimit ?? 30,
                         CustomFormatter: args.options.customFormatter
                     }

package/dist/m365/spo/commands.js

@@ -83,6 +83,7 @@ export default {
     FILE_SHARINGLINK_SET: `${prefix} file sharinglink set`,
     FILE_VERSION_CLEAR: `${prefix} file version clear`,
     FILE_VERSION_GET: `${prefix} file version get`,
+    FILE_VERSION_KEEP: `${prefix} file version keep`,
     FILE_VERSION_LIST: `${prefix} file version list`,
     FILE_VERSION_REMOVE: `${prefix} file version remove`,
     FILE_VERSION_RESTORE: `${prefix} file version restore`,

package/dist/utils/entraApp.js

@@ -143,6 +143,21 @@ export const entraApp = {
                 redirectUris: options.redirectUris.split(',').map(u => u.trim())
             };
         }
+        if (options.platform === 'android') {
+            applicationInfo['publicClient'] = {
+                redirectUris: [
+                    `msauth://${options.bundleId}/${formatting.encodeQueryParameter(options.signatureHash)}`
+                ]
+            };
+        }
+        if (options.platform === 'apple') {
+            applicationInfo['publicClient'] = {
+                redirectUris: [
+                    `msauth://code/msauth.${options.bundleId}%3A%2F%2Fauth`,
+                    `msauth.${options.bundleId}://auth`
+                ]
+            };
+        }
         if (options.implicitFlow) {
             if (!applicationInfo.web) {
                 applicationInfo.web = {};

package/docs/docs/cmd/entra/app/app-add.mdx

@@ -31,7 +31,7 @@ m365 entra appregistration add [options]
 : Comma-separated list of redirect URIs. Requires `platform` to be specified.
 
 `-p, --platform [platform]`
-: Platform for which the `redirectUris` should be configured. Allowed values `spa`, `web`, `publicClient`. Requires `redirectUris` to be specified.
+: Platform for which the app should be configured. Allowed values `spa`, `web`, `publicClient`, `apple`, `android`.
 
 `--implicitFlow`
 : Specify, to indicate that the authorization endpoint should return ID and access tokens.
@@ -75,6 +75,12 @@ m365 entra appregistration add [options]
 `--manifest [manifest]`
 : App manifest as retrieved from Entra ID to create the app registration from. Specify either `name` or `manifest` but not both.
 
+`--bundleId [bundleId]`
+: Specify a bundle Id to add the iOS / macOS or Android platform to the application. Required when platform is `apple` or `android`.
+
+`--signatureHash [signatureHash]`
+: A required hash when specifying a bundle Id and platform `android`.
+
 `--save`
 : Use to store the information about the created app in a local file.
 

package/docs/docs/cmd/flow/environment/environment-get.mdx

@@ -16,7 +16,10 @@ m365 flow environment get [options]
 
 ```md definition-list
 `-n, --name [name]`
-: The name of the environment to get information about. When not specified, the default environment is retrieved.
+: The name of the environment to get information about. When not specified, the default environment is retrieved. Specify either `name` or `default`, but not both.
+
+`--default`
+: Indicates that the default environment should be retrieved. Specify either `name` or `default`, but not both.
 ```
 
 <Global />
@@ -42,13 +45,11 @@ m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 Get information about the default Microsoft Flow environment.
 
 ```sh
-m365 flow environment get
+m365 flow environment get --default
 ```
 
 ## Response
 
-### Standard response
-
 <Tabs>
   <TabItem value="JSON">
 
@@ -153,7 +154,7 @@ m365 flow environment get
   <TabItem value="Markdown">
 
   ```md
-  # flow environment get
+  # flow environment get --default
 
   Date: 8/2/2023