@pnp/cli-microsoft365 12.1.0-beta.dbc076e → 12.1.0-beta.f55735f

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

@@ -1,13 +1,14 @@
-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 _VivaEngageUserGetCommand_instances, _VivaEngageUserGetCommand_initTelemetry, _VivaEngageUserGetCommand_initOptions, _VivaEngageUserGetCommand_initValidators;
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import VivaEngageCommand from '../../../base/VivaEngageCommand.js';
 import commands from '../../commands.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    id: z.coerce.number().optional().alias('i'),
+    email: z.string().optional()
+});
 class VivaEngageUserGetCommand extends VivaEngageCommand {
     get name() {
         return commands.ENGAGE_USER_GET;
@@ -15,12 +16,14 @@ class VivaEngageUserGetCommand extends VivaEngageCommand {
     get description() {
         return 'Retrieves the current user or searches for a user by ID or e-mail';
     }
-    constructor() {
-        super();
-        _VivaEngageUserGetCommand_instances.add(this);
-        __classPrivateFieldGet(this, _VivaEngageUserGetCommand_instances, "m", _VivaEngageUserGetCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _VivaEngageUserGetCommand_instances, "m", _VivaEngageUserGetCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _VivaEngageUserGetCommand_instances, "m", _VivaEngageUserGetCommand_initValidators).call(this);
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(opts => !(opts.id !== undefined && opts.email !== undefined), {
+            message: 'You are only allowed to search by ID or e-mail but not both'
+        });
     }
     async commandAction(logger, args) {
         let endPoint = `${this.resource}/v1/users/current.json`;
@@ -47,26 +50,5 @@ class VivaEngageUserGetCommand extends VivaEngageCommand {
         }
     }
 }
-_VivaEngageUserGetCommand_instances = new WeakSet(), _VivaEngageUserGetCommand_initTelemetry = function _VivaEngageUserGetCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            userId: args.options.id !== undefined,
-            email: args.options.email !== undefined
-        });
-    });
-}, _VivaEngageUserGetCommand_initOptions = function _VivaEngageUserGetCommand_initOptions() {
-    this.options.unshift({
-        option: '-i, --id [id]'
-    }, {
-        option: '--email [email]'
-    });
-}, _VivaEngageUserGetCommand_initValidators = function _VivaEngageUserGetCommand_initValidators() {
-    this.validators.push(async (args) => {
-        if (args.options.id !== undefined && args.options.email !== undefined) {
-            return `You are only allowed to search by ID or e-mail but not both`;
-        }
-        return true;
-    });
-};
 export default new VivaEngageUserGetCommand();
 //# sourceMappingURL=engage-user-get.js.map

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

@@ -1,12 +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 _VivaEngageUserListCommand_instances, _VivaEngageUserListCommand_initTelemetry, _VivaEngageUserListCommand_initOptions, _VivaEngageUserListCommand_initValidators;
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
 import request from '../../../../request.js';
 import VivaEngageCommand from '../../../base/VivaEngageCommand.js';
 import commands from '../../commands.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    groupId: z.coerce.number().optional().alias('g'),
+    letter: z.string().optional().alias('l'),
+    reverse: z.boolean().optional(),
+    limit: z.coerce.number().optional(),
+    sortBy: z.enum(['messages', 'followers']).optional()
+});
 class VivaEngageUserListCommand extends VivaEngageCommand {
     get name() {
         return commands.ENGAGE_USER_LIST;
@@ -17,13 +21,17 @@ class VivaEngageUserListCommand extends VivaEngageCommand {
     defaultProperties() {
         return ['id', 'full_name', 'email'];
     }
-    constructor() {
-        super();
-        _VivaEngageUserListCommand_instances.add(this);
-        this.items = [];
-        __classPrivateFieldGet(this, _VivaEngageUserListCommand_instances, "m", _VivaEngageUserListCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _VivaEngageUserListCommand_instances, "m", _VivaEngageUserListCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _VivaEngageUserListCommand_instances, "m", _VivaEngageUserListCommand_initValidators).call(this);
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(opts => !opts.letter || /^(?!\d)[a-zA-Z]+$/i.test(opts.letter), {
+            message: `Value of 'letter' is invalid. Only characters within the ranges [A - Z], [a - z] are allowed.`
+        })
+            .refine(opts => !opts.letter || opts.letter.length === 1, {
+            message: `Only one char as value of 'letter' accepted.`
+        });
     }
     getAllItems(logger, args, page) {
         return new Promise((resolve, reject) => {
@@ -35,7 +43,7 @@ class VivaEngageUserListCommand extends VivaEngageCommand {
                 endPoint = `${this.resource}/v1/users/in_group/${args.options.groupId}.json`;
             }
             endPoint += `?page=${page}`;
-            if (args.options.reverse !== undefined) {
+            if (args.options.reverse) {
                 endPoint += `&reverse=true`;
             }
             if (args.options.sortBy !== undefined) {
@@ -98,48 +106,5 @@ class VivaEngageUserListCommand extends VivaEngageCommand {
         }
     }
 }
-_VivaEngageUserListCommand_instances = new WeakSet(), _VivaEngageUserListCommand_initTelemetry = function _VivaEngageUserListCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            letter: args.options.letter !== undefined,
-            sortBy: args.options.sortBy !== undefined,
-            reverse: args.options.reverse !== undefined,
-            limit: args.options.limit !== undefined,
-            groupId: args.options.groupId !== undefined
-        });
-    });
-}, _VivaEngageUserListCommand_initOptions = function _VivaEngageUserListCommand_initOptions() {
-    this.options.unshift({
-        option: '-g, --groupId [groupId]'
-    }, {
-        option: '-l, --letter [letter]'
-    }, {
-        option: '--reverse'
-    }, {
-        option: '--limit [limit]'
-    }, {
-        option: '--sortBy [sortBy]',
-        autocomplete: ['messages', 'followers']
-    });
-}, _VivaEngageUserListCommand_initValidators = function _VivaEngageUserListCommand_initValidators() {
-    this.validators.push(async (args) => {
-        if (args.options.groupId && typeof args.options.groupId !== 'number') {
-            return `${args.options.groupId} is not a number`;
-        }
-        if (args.options.limit && typeof args.options.limit !== 'number') {
-            return `${args.options.limit} is not a number`;
-        }
-        if (args.options.sortBy && args.options.sortBy !== 'messages' && args.options.sortBy !== 'followers') {
-            return `sortBy accepts only the values "messages" or "followers"`;
-        }
-        if (args.options.letter && !/^(?!\d)[a-zA-Z]+$/i.test(args.options.letter)) {
-            return `Value of 'letter' is invalid. Only characters within the ranges [A - Z], [a - z] are allowed.`;
-        }
-        if (args.options.letter && args.options.letter.length !== 1) {
-            return `Only one char as value of 'letter' accepted.`;
-        }
-        return true;
-    });
-};
 export default new VivaEngageUserListCommand();
 //# sourceMappingURL=engage-user-list.js.map

package/docs/docs/cmd/spo/listitem/listitem-record-declare.mdx

@@ -36,6 +36,25 @@ m365 spo listitem record declare [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Declare a document with id _1_ as a record in list with title _Demo List_ located in site _https://contoso.sharepoint.com/sites/project-x_

package/docs/docs/cmd/spo/listitem/listitem-record-lock.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo listitem record lock
 
@@ -31,6 +33,25 @@ m365 spo listitem record lock [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Locks the list item record in a given site based on the list id

package/docs/docs/cmd/spo/listitem/listitem-record-undeclare.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo listitem record undeclare
 
@@ -31,6 +33,25 @@ m365 spo listitem record undeclare [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions          |
+  |------------|----------------------|
+  | SharePoint | AllSites.FullControl |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions           |
+  |------------|-----------------------|
+  | SharePoint | Sites.FullControl.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Undeclare the list item as a record with ID _1_ from list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x

package/docs/docs/cmd/spo/listitem/listitem-record-unlock.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo listitem record unlock
 
@@ -31,6 +33,25 @@ m365 spo listitem record unlock [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Unlocks the list item record in a given site based on the list id

package/docs/docs/cmd/spo/page/page-text-add.mdx

@@ -29,7 +29,7 @@ m365 spo page text add [options]
 : Number of the column in which the text should be added (1 or higher).
 
 `--order [order]`
-: Order of the text in the column.
+: Order of the text in the column. Must be integer value of 1 or higher.
 ```
 
 <Global />

package/docs/docs/cmd/viva/engage/engage-community-add.mdx

@@ -46,6 +46,25 @@ This command is based on an API that is currently in preview and is subject to c
 
 Creating a community is limited to networks in Native mode only - legacy and external Yammer networks will not be able to use this API for community creation.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                 |
+  |-----------------|---------------------------------------------|
+  | Microsoft Graph | Community.ReadWrite.All, User.ReadBasic.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                 |
+  |-----------------|---------------------------------------------|
+  | Microsoft Graph | Community.ReadWrite.All, User.ReadBasic.All | 
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a public community and wait for the community to be created

package/docs/docs/cmd/viva/engage/engage-community-get.mdx

@@ -29,6 +29,25 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Community.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Community.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a specific community by ID.

package/docs/docs/cmd/viva/engage/engage-community-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # viva engage community remove
 
@@ -36,6 +38,25 @@ When the Viva Engage community is removed, all the associated Microsoft 365 cont
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | Community.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | Community.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a community specified by id without prompting

package/docs/docs/cmd/viva/engage/engage-community-set.mdx

@@ -36,6 +36,25 @@ m365 viva engage community set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | Community.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | Community.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update info about the community specified by id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "12.1.0-beta.dbc076e",
+  "version": "12.1.0-beta.f55735f",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",