@pnp/cli-microsoft365 12.0.0-beta.bf446c8 → 12.0.0-beta.d0b29c1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/.devproxy/generate-openapi-spec.json +1 -1
  2. package/allCommands.json +1 -1
  3. package/allCommandsFull.json +1 -1
  4. package/dist/googleAnalytics.js +96 -0
  5. package/dist/m365/spfx/commands/SpfxCompatibilityMatrix.js +15 -0
  6. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.24.0-rc.0.js +19 -0
  7. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  8. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN012021_TSC_excludeDirectories.js +43 -0
  9. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN027002_OVERRIDES_qs.js +33 -0
  10. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN027003_OVERRIDES_uuid.js +33 -0
  11. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.24.0-rc.0.js +77 -0
  12. package/dist/m365/spfx/commands/project/project-upgrade.js +12 -11
  13. package/dist/m365/spo/commands/app/app-add.js +35 -56
  14. package/dist/m365/spo/commands/app/app-deploy.js +41 -59
  15. package/dist/m365/spo/commands/app/app-get.js +40 -56
  16. package/dist/m365/spo/commands/app/app-install.js +20 -41
  17. package/dist/m365/spo/commands/app/app-instance-list.js +12 -24
  18. package/dist/m365/spo/commands/app/app-list.js +26 -44
  19. package/dist/m365/spo/commands/app/app-remove.js +32 -52
  20. package/dist/m365/spo/commands/app/app-retract.js +32 -51
  21. package/dist/m365/spo/commands/app/app-teamspackage-download.js +35 -54
  22. package/dist/m365/spo/commands/app/app-uninstall.js +21 -44
  23. package/dist/m365/spo/commands/app/app-upgrade.js +20 -41
  24. package/dist/m365/spo/commands/feature/feature-disable.js +20 -50
  25. package/dist/m365/spo/commands/feature/feature-enable.js +22 -50
  26. package/dist/m365/spo/commands/feature/feature-list.js +11 -36
  27. package/dist/m365/spo/commands/field/field-add.js +33 -62
  28. package/dist/m365/spo/commands/field/field-get.js +30 -57
  29. package/dist/m365/spo/commands/field/field-list.js +21 -46
  30. package/dist/m365/spo/commands/field/field-remove.js +32 -63
  31. package/dist/m365/spo/commands/field/field-set.js +34 -66
  32. package/dist/m365/spo/commands/file/file-get.js +4 -3
  33. package/dist/m365/spo/commands/folder/folder-unarchive.js +90 -0
  34. package/dist/m365/spo/commands/hubsite/hubsite-connect.js +38 -63
  35. package/dist/m365/spo/commands/hubsite/hubsite-data-get.js +11 -27
  36. package/dist/m365/spo/commands/hubsite/hubsite-disconnect.js +25 -47
  37. package/dist/m365/spo/commands/hubsite/hubsite-get.js +25 -37
  38. package/dist/m365/spo/commands/hubsite/hubsite-list.js +12 -24
  39. package/dist/m365/spo/commands/hubsite/hubsite-register.js +10 -18
  40. package/dist/m365/spo/commands/hubsite/hubsite-rights-grant.js +14 -32
  41. package/dist/m365/spo/commands/hubsite/hubsite-rights-revoke.js +12 -29
  42. package/dist/m365/spo/commands/hubsite/hubsite-set.js +19 -46
  43. package/dist/m365/spo/commands/hubsite/hubsite-unregister.js +11 -27
  44. package/dist/m365/spo/commands/navigation/navigation-node-add.js +74 -120
  45. package/dist/m365/spo/commands/navigation/navigation-node-get.js +4 -13
  46. package/dist/m365/spo/commands/navigation/navigation-node-set.js +53 -114
  47. package/dist/m365/spo/commands/page/page-unpublish.js +53 -0
  48. package/dist/m365/spo/commands.js +3 -1
  49. package/dist/m365/teams/commands/chat/chat-get.js +30 -45
  50. package/dist/m365/teams/commands/chat/chat-list.js +22 -42
  51. package/dist/m365/teams/commands/chat/chat-member-add.js +43 -64
  52. package/dist/m365/teams/commands/chat/chat-member-list.js +10 -23
  53. package/dist/m365/teams/commands/chat/chat-member-remove.js +28 -50
  54. package/dist/m365/teams/commands/chat/chat-message-send.js +32 -55
  55. package/dist/m365/util/commands/accesstoken/accesstoken-get.js +10 -28
  56. package/dist/telemetry.js +7 -11
  57. package/dist/utils/spo.js +39 -0
  58. package/docs/docs/cmd/spo/file/file-archive.mdx +1 -1
  59. package/docs/docs/cmd/spo/file/file-checkin.mdx +2 -2
  60. package/docs/docs/cmd/spo/file/file-checkout-undo.mdx +1 -1
  61. package/docs/docs/cmd/spo/file/file-checkout.mdx +2 -2
  62. package/docs/docs/cmd/spo/file/file-copy.mdx +2 -2
  63. package/docs/docs/cmd/spo/file/file-get.mdx +6 -6
  64. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  65. package/docs/docs/cmd/spo/file/file-retentionlabel-remove.mdx +1 -1
  66. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +1 -1
  67. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  68. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +3 -3
  69. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +2 -2
  70. package/docs/docs/cmd/spo/file/file-sharinginfo-get.mdx +2 -2
  71. package/docs/docs/cmd/spo/file/file-sharinglink-add.mdx +1 -1
  72. package/docs/docs/cmd/spo/file/file-sharinglink-clear.mdx +1 -1
  73. package/docs/docs/cmd/spo/file/file-sharinglink-get.mdx +1 -1
  74. package/docs/docs/cmd/spo/file/file-sharinglink-list.mdx +1 -1
  75. package/docs/docs/cmd/spo/file/file-sharinglink-remove.mdx +1 -1
  76. package/docs/docs/cmd/spo/file/file-sharinglink-set.mdx +1 -1
  77. package/docs/docs/cmd/spo/file/file-unarchive.mdx +1 -1
  78. package/docs/docs/cmd/spo/file/file-version-clear.mdx +1 -1
  79. package/docs/docs/cmd/spo/file/file-version-get.mdx +1 -1
  80. package/docs/docs/cmd/spo/file/file-version-keep.mdx +1 -1
  81. package/docs/docs/cmd/spo/file/file-version-list.mdx +1 -1
  82. package/docs/docs/cmd/spo/file/file-version-remove.mdx +1 -1
  83. package/docs/docs/cmd/spo/file/file-version-restore.mdx +1 -1
  84. package/docs/docs/cmd/spo/folder/folder-archive.mdx +1 -1
  85. package/docs/docs/cmd/spo/folder/folder-copy.mdx +1 -1
  86. package/docs/docs/cmd/spo/folder/folder-get.mdx +2 -2
  87. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +1 -1
  88. package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.mdx +1 -1
  89. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +1 -1
  90. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +1 -1
  91. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +1 -1
  92. package/docs/docs/cmd/spo/folder/folder-unarchive.mdx +76 -0
  93. package/docs/docs/cmd/spo/navigation/navigation-node-add.mdx +45 -30
  94. package/docs/docs/cmd/spo/navigation/navigation-node-get.mdx +64 -42
  95. package/docs/docs/cmd/spo/navigation/navigation-node-set.mdx +10 -8
  96. package/docs/docs/cmd/spo/page/page-unpublish.mdx +63 -0
  97. package/docs/docs/cmd/spp/model/model-get.mdx +1 -1
  98. package/docs/docs/cmd/spp/model/model-remove.mdx +1 -1
  99. package/docs/docs/cmd/teams/tab/tab-add.mdx +19 -0
  100. package/docs/docs/cmd/teams/tab/tab-get.mdx +19 -0
  101. package/docs/docs/cmd/teams/tab/tab-list.mdx +19 -0
  102. package/docs/docs/cmd/teams/tab/tab-remove.mdx +21 -0
  103. package/docs/docs/cmd/viva/engage/engage-message-add.mdx +17 -0
  104. package/docs/docs/cmd/viva/engage/engage-message-get.mdx +17 -0
  105. package/docs/docs/cmd/viva/engage/engage-message-list.mdx +17 -0
  106. package/docs/docs/cmd/viva/engage/engage-message-remove.mdx +19 -0
  107. package/npm-shrinkwrap.json +324 -3116
  108. package/package.json +17 -35
  109. package/dist/appInsights.js +0 -43
@@ -1,16 +1,21 @@
1
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
- 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");
4
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
- };
6
- var _SpoHubSiteSetCommand_instances, _SpoHubSiteSetCommand_initTelemetry, _SpoHubSiteSetCommand_initOptions, _SpoHubSiteSetCommand_initValidators, _SpoHubSiteSetCommand_initTypes;
1
+ import { z } from 'zod';
7
2
  import config from '../../../../config.js';
3
+ import { globalOptionsZod } from '../../../../Command.js';
8
4
  import request from '../../../../request.js';
9
5
  import { formatting } from '../../../../utils/formatting.js';
10
6
  import { spo } from '../../../../utils/spo.js';
11
7
  import { validation } from '../../../../utils/validation.js';
12
8
  import SpoCommand from '../../../base/SpoCommand.js';
13
9
  import commands from '../../commands.js';
10
+ export const options = z.strictObject({
11
+ ...globalOptionsZod.shape,
12
+ id: z.string().refine(id => validation.isValidGuid(id), {
13
+ error: e => `${e.input} is not a valid GUID`
14
+ }).alias('i'),
15
+ title: z.string().optional().alias('t'),
16
+ description: z.string().optional().alias('d'),
17
+ logoUrl: z.string().optional().alias('l')
18
+ });
14
19
  class SpoHubSiteSetCommand extends SpoCommand {
15
20
  get name() {
16
21
  return commands.HUBSITE_SET;
@@ -18,13 +23,14 @@ class SpoHubSiteSetCommand extends SpoCommand {
18
23
  get description() {
19
24
  return 'Updates properties of the specified hub site';
20
25
  }
21
- constructor() {
22
- super();
23
- _SpoHubSiteSetCommand_instances.add(this);
24
- __classPrivateFieldGet(this, _SpoHubSiteSetCommand_instances, "m", _SpoHubSiteSetCommand_initTelemetry).call(this);
25
- __classPrivateFieldGet(this, _SpoHubSiteSetCommand_instances, "m", _SpoHubSiteSetCommand_initOptions).call(this);
26
- __classPrivateFieldGet(this, _SpoHubSiteSetCommand_instances, "m", _SpoHubSiteSetCommand_initValidators).call(this);
27
- __classPrivateFieldGet(this, _SpoHubSiteSetCommand_instances, "m", _SpoHubSiteSetCommand_initTypes).call(this);
26
+ get schema() {
27
+ return options;
28
+ }
29
+ getRefinedSchema(schema) {
30
+ return schema
31
+ .refine(opts => opts.title !== undefined || opts.description !== undefined || opts.logoUrl !== undefined, {
32
+ error: 'Specify title, description or logoUrl to update'
33
+ });
28
34
  }
29
35
  async commandAction(logger, args) {
30
36
  try {
@@ -62,38 +68,5 @@ class SpoHubSiteSetCommand extends SpoCommand {
62
68
  }
63
69
  }
64
70
  }
65
- _SpoHubSiteSetCommand_instances = new WeakSet(), _SpoHubSiteSetCommand_initTelemetry = function _SpoHubSiteSetCommand_initTelemetry() {
66
- this.telemetry.push((args) => {
67
- Object.assign(this.telemetryProperties, {
68
- title: typeof args.options.title === 'string',
69
- description: typeof args.options.description === 'string',
70
- logoUrl: typeof args.options.logoUrl === 'string'
71
- });
72
- });
73
- }, _SpoHubSiteSetCommand_initOptions = function _SpoHubSiteSetCommand_initOptions() {
74
- this.options.unshift({
75
- option: '-i, --id <id>'
76
- }, {
77
- option: '-t, --title [title]'
78
- }, {
79
- option: '-d, --description [description]'
80
- }, {
81
- option: '-l, --logoUrl [logoUrl]'
82
- });
83
- }, _SpoHubSiteSetCommand_initValidators = function _SpoHubSiteSetCommand_initValidators() {
84
- this.validators.push(async (args) => {
85
- if (!validation.isValidGuid(args.options.id)) {
86
- return `${args.options.id} is not a valid GUID`;
87
- }
88
- if (!args.options.title &&
89
- !args.options.description &&
90
- !args.options.logoUrl) {
91
- return 'Specify title, description or logoUrl to update';
92
- }
93
- return true;
94
- });
95
- }, _SpoHubSiteSetCommand_initTypes = function _SpoHubSiteSetCommand_initTypes() {
96
- this.types.string.push('t', 'title', 'd', 'description', 'l', 'logoUrl');
97
- };
98
71
  export default new SpoHubSiteSetCommand();
99
72
  //# sourceMappingURL=hubsite-set.js.map
@@ -1,15 +1,18 @@
1
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
- 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");
4
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
- };
6
- var _SpoHubSiteUnregisterCommand_instances, _SpoHubSiteUnregisterCommand_initTelemetry, _SpoHubSiteUnregisterCommand_initOptions, _SpoHubSiteUnregisterCommand_initValidators;
1
+ import { z } from 'zod';
7
2
  import { cli } from '../../../../cli/cli.js';
3
+ import { globalOptionsZod } from '../../../../Command.js';
8
4
  import request from '../../../../request.js';
9
5
  import { spo } from '../../../../utils/spo.js';
10
6
  import { validation } from '../../../../utils/validation.js';
11
7
  import SpoCommand from '../../../base/SpoCommand.js';
12
8
  import commands from '../../commands.js';
9
+ export const options = z.strictObject({
10
+ ...globalOptionsZod.shape,
11
+ url: z.string().refine(url => validation.isValidSharePointUrl(url) === true, {
12
+ error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
13
+ }).alias('u'),
14
+ force: z.boolean().optional().alias('f')
15
+ });
13
16
  class SpoHubSiteUnregisterCommand extends SpoCommand {
14
17
  get name() {
15
18
  return commands.HUBSITE_UNREGISTER;
@@ -17,12 +20,8 @@ class SpoHubSiteUnregisterCommand extends SpoCommand {
17
20
  get description() {
18
21
  return 'Unregisters the specified site collection as a hub site';
19
22
  }
20
- constructor() {
21
- super();
22
- _SpoHubSiteUnregisterCommand_instances.add(this);
23
- __classPrivateFieldGet(this, _SpoHubSiteUnregisterCommand_instances, "m", _SpoHubSiteUnregisterCommand_initTelemetry).call(this);
24
- __classPrivateFieldGet(this, _SpoHubSiteUnregisterCommand_instances, "m", _SpoHubSiteUnregisterCommand_initOptions).call(this);
25
- __classPrivateFieldGet(this, _SpoHubSiteUnregisterCommand_instances, "m", _SpoHubSiteUnregisterCommand_initValidators).call(this);
23
+ get schema() {
24
+ return options;
26
25
  }
27
26
  async commandAction(logger, args) {
28
27
  const unregisterHubSite = async () => {
@@ -56,20 +55,5 @@ class SpoHubSiteUnregisterCommand extends SpoCommand {
56
55
  }
57
56
  }
58
57
  }
59
- _SpoHubSiteUnregisterCommand_instances = new WeakSet(), _SpoHubSiteUnregisterCommand_initTelemetry = function _SpoHubSiteUnregisterCommand_initTelemetry() {
60
- this.telemetry.push((args) => {
61
- Object.assign(this.telemetryProperties, {
62
- force: args.options.force || false
63
- });
64
- });
65
- }, _SpoHubSiteUnregisterCommand_initOptions = function _SpoHubSiteUnregisterCommand_initOptions() {
66
- this.options.unshift({
67
- option: '-u, --url <url>'
68
- }, {
69
- option: '-f, --force'
70
- });
71
- }, _SpoHubSiteUnregisterCommand_initValidators = function _SpoHubSiteUnregisterCommand_initValidators() {
72
- this.validators.push(async (args) => validation.isValidSharePointUrl(args.options.url));
73
- };
74
58
  export default new SpoHubSiteUnregisterCommand();
75
59
  //# sourceMappingURL=hubsite-unregister.js.map
@@ -1,14 +1,30 @@
1
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
- 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");
4
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
- };
6
- var _SpoNavigationNodeAddCommand_instances, _SpoNavigationNodeAddCommand_initTelemetry, _SpoNavigationNodeAddCommand_initOptions, _SpoNavigationNodeAddCommand_initValidators, _SpoNavigationNodeAddCommand_initOptionSets;
7
- import request from '../../../../request.js';
1
+ import { globalOptionsZod } from '../../../../Command.js';
2
+ import { z } from 'zod';
8
3
  import { spo } from '../../../../utils/spo.js';
9
4
  import { validation } from '../../../../utils/validation.js';
10
5
  import SpoCommand from '../../../base/SpoCommand.js';
11
6
  import commands from '../../commands.js';
7
+ export const options = z.strictObject({
8
+ ...globalOptionsZod.shape,
9
+ webUrl: z.string()
10
+ .refine(url => validation.isValidSharePointUrl(url) === true, {
11
+ error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
12
+ })
13
+ .alias('u'),
14
+ location: z.enum(['QuickLaunch', 'TopNavigationBar']).optional().alias('l'),
15
+ title: z.string().min(1, 'Cannot be empty.').alias('t'),
16
+ url: z.string().optional(),
17
+ parentNodeId: z.int().positive().optional(),
18
+ audienceIds: z.string()
19
+ .refine(audienceIds => audienceIds.split(',').length <= 10, {
20
+ error: 'The maximum amount of audienceIds per navigation node exceeded. The maximum amount of audienceIds is 10.'
21
+ })
22
+ .refine(audienceIds => validation.isValidGuidArray(audienceIds) === true, {
23
+ error: e => `The following GUIDs are invalid for the option 'audienceIds': ${validation.isValidGuidArray(e.input)}.`
24
+ })
25
+ .optional(),
26
+ openInNewWindow: z.boolean().optional()
27
+ });
12
28
  class SpoNavigationNodeAddCommand extends SpoCommand {
13
29
  get name() {
14
30
  return commands.NAVIGATION_NODE_ADD;
@@ -16,134 +32,72 @@ class SpoNavigationNodeAddCommand extends SpoCommand {
16
32
  get description() {
17
33
  return 'Adds a navigation node to the specified site navigation';
18
34
  }
19
- constructor() {
20
- super();
21
- _SpoNavigationNodeAddCommand_instances.add(this);
22
- __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initTelemetry).call(this);
23
- __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initOptions).call(this);
24
- __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initValidators).call(this);
25
- __classPrivateFieldGet(this, _SpoNavigationNodeAddCommand_instances, "m", _SpoNavigationNodeAddCommand_initOptionSets).call(this);
35
+ get schema() {
36
+ return options;
37
+ }
38
+ getRefinedSchema(schema) {
39
+ return schema
40
+ .refine(options => [options.location, options.parentNodeId].filter(o => o !== undefined).length === 1, {
41
+ error: `Specify either 'location' or 'parentNodeId', but not both.`,
42
+ params: {
43
+ customCode: 'optionSet',
44
+ options: ['location', 'parentNodeId']
45
+ }
46
+ });
26
47
  }
27
48
  getExcludedOptionsWithUrls() {
28
49
  return ['url'];
29
50
  }
30
51
  async commandAction(logger, args) {
52
+ const { webUrl, location, parentNodeId, title, url, audienceIds, openInNewWindow } = args.options;
31
53
  if (this.verbose) {
32
54
  await logger.logToStderr(`Adding navigation node...`);
33
55
  }
34
- const nodesCollection = args.options.parentNodeId ?
35
- `GetNodeById(${args.options.parentNodeId})/Children` :
36
- args.options.location.toLowerCase();
37
- const requestOptions = {
38
- url: `${args.options.webUrl}/_api/web/navigation/${nodesCollection}`,
39
- headers: {
40
- accept: 'application/json;odata=nometadata',
41
- 'content-type': 'application/json;odata=nometadata'
42
- },
43
- responseType: 'json',
44
- data: {
45
- AudienceIds: args.options.audienceIds?.split(','),
46
- Title: args.options.title,
47
- Url: args.options.url ?? 'http://linkless.header/',
48
- IsExternal: args.options.isExternal === true
49
- }
50
- };
51
56
  try {
52
- const res = await request.post(requestOptions);
53
- if (args.options.openInNewWindow) {
54
- if (this.verbose) {
55
- await logger.logToStderr(`Making sure that the newly added navigation node opens in a new window.`);
56
- }
57
- const id = res.Id.toString();
58
- let menuState = args.options.location === 'TopNavigationBar' ? await spo.getTopNavigationMenuState(args.options.webUrl) : await spo.getQuickLaunchMenuState(args.options.webUrl);
59
- let menuStateItem = this.getMenuStateNode(menuState.Nodes, id);
60
- if (args.options.parentNodeId && !menuStateItem) {
61
- menuState = await spo.getTopNavigationMenuState(args.options.webUrl);
62
- menuStateItem = this.getMenuStateNode(menuState.Nodes, id);
63
- }
64
- menuStateItem.OpenInNewWindow = true;
65
- await spo.saveMenuState(args.options.webUrl, menuState);
57
+ let menuState;
58
+ let siblingNodes;
59
+ if (parentNodeId) {
60
+ const parent = await spo.getMenuStateNodeByKey(webUrl, parentNodeId.toString());
61
+ menuState = parent.menuState;
62
+ siblingNodes = parent.node.Nodes;
63
+ }
64
+ else {
65
+ menuState = location === 'TopNavigationBar'
66
+ ? await spo.getTopNavigationMenuState(webUrl)
67
+ : await spo.getQuickLaunchMenuState(webUrl);
68
+ siblingNodes = menuState.Nodes;
66
69
  }
67
- await logger.log(res);
70
+ const existingKeys = siblingNodes.map(node => node.Key);
71
+ const newNode = {
72
+ AudienceIds: audienceIds ? audienceIds.split(',') : [],
73
+ IsDeleted: false,
74
+ IsHidden: false,
75
+ Key: null,
76
+ Nodes: [],
77
+ NodeType: 0,
78
+ OpenInNewWindow: openInNewWindow ? true : null,
79
+ SimpleUrl: url ?? '',
80
+ Title: title
81
+ };
82
+ siblingNodes.push(newNode);
83
+ await spo.saveMenuState(webUrl, menuState);
84
+ if (this.verbose) {
85
+ await logger.logToStderr(`Retrieving the added navigation node...`);
86
+ }
87
+ const updatedMenuState = await spo.getMenuState(webUrl, menuState.StartingNodeKey);
88
+ const updatedSiblingNodes = parentNodeId
89
+ ? spo.findMenuStateNode(updatedMenuState.Nodes, parentNodeId.toString())?.Nodes
90
+ : updatedMenuState.Nodes;
91
+ const addedNode = updatedSiblingNodes?.find(node => !existingKeys.includes(node.Key) && node.Title === title);
92
+ if (!addedNode) {
93
+ throw `The navigation node was added, but it couldn't be retrieved.`;
94
+ }
95
+ await logger.log(addedNode);
68
96
  }
69
97
  catch (err) {
70
98
  this.handleRejectedODataJsonPromise(err);
71
99
  }
72
100
  }
73
- getMenuStateNode(nodes, id) {
74
- let menuNode = nodes.find((node) => node.Key !== null && node.Key === id);
75
- if (menuNode === undefined) {
76
- for (const node of nodes.filter(node => node.Nodes.length > 0)) {
77
- menuNode = this.getMenuStateNode(node.Nodes, id);
78
- if (menuNode) {
79
- break;
80
- }
81
- }
82
- }
83
- return menuNode;
84
- }
85
101
  }
86
- _SpoNavigationNodeAddCommand_instances = new WeakSet(), _SpoNavigationNodeAddCommand_initTelemetry = function _SpoNavigationNodeAddCommand_initTelemetry() {
87
- this.telemetry.push((args) => {
88
- Object.assign(this.telemetryProperties, {
89
- isExternal: args.options.isExternal,
90
- location: typeof args.options.location !== 'undefined',
91
- parentNodeId: typeof args.options.parentNodeId !== 'undefined',
92
- audienceIds: typeof args.options.audienceIds !== 'undefined',
93
- url: typeof args.options.url !== 'undefined',
94
- openInNewWindow: !!args.options.openInNewWindow
95
- });
96
- });
97
- }, _SpoNavigationNodeAddCommand_initOptions = function _SpoNavigationNodeAddCommand_initOptions() {
98
- this.options.unshift({
99
- option: '-u, --webUrl <webUrl>'
100
- }, {
101
- option: '-l, --location [location]',
102
- autocomplete: ['QuickLaunch', 'TopNavigationBar']
103
- }, {
104
- option: '-t, --title <title>'
105
- }, {
106
- option: '--url [url]'
107
- }, {
108
- option: '--parentNodeId [parentNodeId]'
109
- }, {
110
- option: '--isExternal'
111
- }, {
112
- option: '--audienceIds [audienceIds]'
113
- }, {
114
- option: '--openInNewWindow'
115
- });
116
- }, _SpoNavigationNodeAddCommand_initValidators = function _SpoNavigationNodeAddCommand_initValidators() {
117
- this.validators.push(async (args) => {
118
- const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
119
- if (isValidSharePointUrl !== true) {
120
- return isValidSharePointUrl;
121
- }
122
- if (args.options.parentNodeId) {
123
- if (isNaN(args.options.parentNodeId)) {
124
- return `${args.options.parentNodeId} is not a number`;
125
- }
126
- }
127
- else {
128
- if (args.options.location !== 'QuickLaunch' &&
129
- args.options.location !== 'TopNavigationBar') {
130
- return `${args.options.location} is not a valid value for the location option. Allowed values are QuickLaunch|TopNavigationBar`;
131
- }
132
- }
133
- if (args.options.audienceIds) {
134
- const audienceIdsSplitted = args.options.audienceIds.split(',');
135
- if (audienceIdsSplitted.length > 10) {
136
- return 'The maximum amount of audienceIds per navigation node exceeded. The maximum amount of auciendeIds is 10.';
137
- }
138
- const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.audienceIds);
139
- if (isValidGUIDArrayResult !== true) {
140
- return `The following GUIDs are invalid for the option 'audienceIds': ${isValidGUIDArrayResult}.`;
141
- }
142
- }
143
- return true;
144
- });
145
- }, _SpoNavigationNodeAddCommand_initOptionSets = function _SpoNavigationNodeAddCommand_initOptionSets() {
146
- this.optionSets.push({ options: ['location', 'parentNodeId'] });
147
- };
148
102
  export default new SpoNavigationNodeAddCommand();
149
103
  //# sourceMappingURL=navigation-node-add.js.map
@@ -1,6 +1,6 @@
1
1
  import { globalOptionsZod } from '../../../../Command.js';
2
2
  import { z } from 'zod';
3
- import request from '../../../../request.js';
3
+ import { spo } from '../../../../utils/spo.js';
4
4
  import { validation } from '../../../../utils/validation.js';
5
5
  import SpoCommand from '../../../base/SpoCommand.js';
6
6
  import commands from '../../commands.js';
@@ -11,6 +11,7 @@ export const options = z.strictObject({
11
11
  error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
12
12
  })
13
13
  .alias('u'),
14
+ location: z.enum(['QuickLaunch', 'TopNavigationBar']).alias('l'),
14
15
  id: z.int().positive()
15
16
  });
16
17
  class SpoNavigationNodeGetCommand extends SpoCommand {
@@ -27,19 +28,9 @@ class SpoNavigationNodeGetCommand extends SpoCommand {
27
28
  if (this.verbose) {
28
29
  await logger.logToStderr(`Retrieving information about navigation node with id ${args.options.id}`);
29
30
  }
30
- const requestOptions = {
31
- url: `${args.options.webUrl}/_api/web/navigation/GetNodeById(${args.options.id})?$expand=Children,Children/Children,Children/Children/Children`,
32
- headers: {
33
- accept: 'application/json;odata=nometadata'
34
- },
35
- responseType: 'json'
36
- };
37
31
  try {
38
- const listInstance = await request.get(requestOptions);
39
- if (listInstance['odata.null']) {
40
- throw `No navigation node found with id ${args.options.id}.`;
41
- }
42
- await logger.log(listInstance);
32
+ const { node } = await spo.getMenuStateNodeByKey(args.options.webUrl, args.options.id.toString(), args.options.location);
33
+ await logger.log(node);
43
34
  }
44
35
  catch (err) {
45
36
  this.handleRejectedODataJsonPromise(err);
@@ -1,139 +1,78 @@
1
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
- 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");
4
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
- };
6
- var _SpoNavigationNodeSetCommand_instances, _SpoNavigationNodeSetCommand_initTelemetry, _SpoNavigationNodeSetCommand_initTypes, _SpoNavigationNodeSetCommand_initOptions, _SpoNavigationNodeSetCommand_initValidators;
7
- import request from '../../../../request.js';
1
+ import { globalOptionsZod } from '../../../../Command.js';
2
+ import { z } from 'zod';
8
3
  import { spo } from '../../../../utils/spo.js';
9
4
  import { validation } from '../../../../utils/validation.js';
10
5
  import SpoCommand from '../../../base/SpoCommand.js';
11
6
  import commands from '../../commands.js';
7
+ export const options = z.strictObject({
8
+ ...globalOptionsZod.shape,
9
+ webUrl: z.string()
10
+ .refine(url => validation.isValidSharePointUrl(url) === true, {
11
+ error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
12
+ })
13
+ .alias('u'),
14
+ location: z.enum(['QuickLaunch', 'TopNavigationBar']).alias('l'),
15
+ id: z.int().positive(),
16
+ title: z.string().min(1, 'Cannot be empty.').optional(),
17
+ url: z.string().optional(),
18
+ audienceIds: z.string()
19
+ .refine(audienceIds => audienceIds === '' || audienceIds.split(',').length <= 10, {
20
+ error: 'The maximum amount of audienceIds per navigation node exceeded. The maximum amount of audienceIds is 10.'
21
+ })
22
+ .refine(audienceIds => audienceIds === '' || validation.isValidGuidArray(audienceIds) === true, {
23
+ error: e => `The following GUIDs are invalid for the option 'audienceIds': ${validation.isValidGuidArray(e.input)}.`
24
+ })
25
+ .optional(),
26
+ openInNewWindow: z.boolean().optional()
27
+ });
12
28
  class SpoNavigationNodeSetCommand extends SpoCommand {
13
29
  get name() {
14
30
  return commands.NAVIGATION_NODE_SET;
15
31
  }
16
32
  get description() {
17
- return 'Adds a navigation node to the specified site navigation';
33
+ return 'Updates a SharePoint navigation node';
18
34
  }
19
- constructor() {
20
- super();
21
- _SpoNavigationNodeSetCommand_instances.add(this);
22
- __classPrivateFieldGet(this, _SpoNavigationNodeSetCommand_instances, "m", _SpoNavigationNodeSetCommand_initTelemetry).call(this);
23
- __classPrivateFieldGet(this, _SpoNavigationNodeSetCommand_instances, "m", _SpoNavigationNodeSetCommand_initOptions).call(this);
24
- __classPrivateFieldGet(this, _SpoNavigationNodeSetCommand_instances, "m", _SpoNavigationNodeSetCommand_initTypes).call(this);
25
- __classPrivateFieldGet(this, _SpoNavigationNodeSetCommand_instances, "m", _SpoNavigationNodeSetCommand_initValidators).call(this);
35
+ get schema() {
36
+ return options;
37
+ }
38
+ getRefinedSchema(schema) {
39
+ return schema
40
+ .refine(options => [options.title, options.url, options.audienceIds, options.openInNewWindow].some(o => o !== undefined), {
41
+ error: 'Specify at least one property to update.',
42
+ params: {
43
+ customCode: 'optionSet',
44
+ options: ['title', 'url', 'audienceIds', 'openInNewWindow']
45
+ }
46
+ });
47
+ }
48
+ getExcludedOptionsWithUrls() {
49
+ return ['url'];
26
50
  }
27
51
  async commandAction(logger, args) {
52
+ const { webUrl, location, id, title, url, audienceIds, openInNewWindow } = args.options;
53
+ if (this.verbose) {
54
+ await logger.logToStderr(`Updating navigation node with id ${id}...`);
55
+ }
28
56
  try {
29
- if (this.verbose) {
30
- await logger.logToStderr(`Setting navigation node...`);
31
- }
32
- let url = args.options.url;
33
- if (url === '') {
34
- url = 'http://linkless.header/';
57
+ const { menuState, node } = await spo.getMenuStateNodeByKey(webUrl, id.toString(), location);
58
+ if (title !== undefined) {
59
+ node.Title = title;
35
60
  }
36
- const requestBody = {
37
- Title: args.options.title,
38
- IsExternal: args.options.isExternal,
39
- Url: url
40
- };
41
- if (args.options.audienceIds !== undefined) {
42
- requestBody.AudienceIds = args.options.audienceIds === '' ? [] : args.options.audienceIds.split(',');
61
+ if (url !== undefined) {
62
+ node.SimpleUrl = url;
43
63
  }
44
- const requestOptions = {
45
- url: `${args.options.webUrl}/_api/web/navigation/GetNodeById(${args.options.id})`,
46
- headers: {
47
- accept: 'application/json;odata=nometadata',
48
- 'content-type': 'application/json;odata=nometadata'
49
- },
50
- data: requestBody,
51
- responseType: 'json'
52
- };
53
- const response = await request.patch(requestOptions);
54
- if (response['odata.null'] === true) {
55
- throw `Navigation node does not exist.`;
64
+ if (audienceIds !== undefined) {
65
+ node.AudienceIds = audienceIds === '' ? [] : audienceIds.split(',');
56
66
  }
57
- if (args.options.openInNewWindow !== undefined) {
58
- if (this.verbose) {
59
- await logger.logToStderr(`Making sure that the navigation node opens in a new window.`);
60
- }
61
- let menuState = await spo.getQuickLaunchMenuState(args.options.webUrl);
62
- let menuStateItem = this.getMenuStateNode(menuState.Nodes, args.options.id);
63
- if (!menuStateItem) {
64
- menuState = await spo.getTopNavigationMenuState(args.options.webUrl);
65
- menuStateItem = this.getMenuStateNode(menuState.Nodes, args.options.id);
66
- }
67
- menuStateItem.OpenInNewWindow = args.options.openInNewWindow;
68
- await spo.saveMenuState(args.options.webUrl, menuState);
67
+ if (openInNewWindow !== undefined) {
68
+ node.OpenInNewWindow = openInNewWindow;
69
69
  }
70
+ await spo.saveMenuState(webUrl, menuState);
70
71
  }
71
72
  catch (err) {
72
73
  this.handleRejectedODataJsonPromise(err);
73
74
  }
74
75
  }
75
- getMenuStateNode(nodes, id) {
76
- let menuNode = nodes.find((node) => node.Key.toString() === id.toString());
77
- if (menuNode === undefined) {
78
- for (const node of nodes.filter(node => node.Nodes.length > 0)) {
79
- menuNode = this.getMenuStateNode(node.Nodes, id);
80
- if (menuNode) {
81
- break;
82
- }
83
- }
84
- }
85
- return menuNode;
86
- }
87
76
  }
88
- _SpoNavigationNodeSetCommand_instances = new WeakSet(), _SpoNavigationNodeSetCommand_initTelemetry = function _SpoNavigationNodeSetCommand_initTelemetry() {
89
- this.telemetry.push((args) => {
90
- Object.assign(this.telemetryProperties, {
91
- title: typeof args.options.title !== 'undefined',
92
- url: typeof args.options.url !== 'undefined',
93
- isExternal: typeof args.options.isExternal !== 'undefined',
94
- audienceIds: typeof args.options.audienceIds !== 'undefined',
95
- openInNewWindow: typeof args.options.openInNewWindow !== 'undefined'
96
- });
97
- });
98
- }, _SpoNavigationNodeSetCommand_initTypes = function _SpoNavigationNodeSetCommand_initTypes() {
99
- this.types.boolean.push('isExternal');
100
- }, _SpoNavigationNodeSetCommand_initOptions = function _SpoNavigationNodeSetCommand_initOptions() {
101
- this.options.unshift({
102
- option: '-u, --webUrl <webUrl>'
103
- }, {
104
- option: '--id <id>'
105
- }, {
106
- option: '--title [title]'
107
- }, {
108
- option: '--url [url]'
109
- }, {
110
- option: '--audienceIds [audienceIds]'
111
- }, {
112
- option: '--isExternal [isExternal]'
113
- }, {
114
- option: '--openInNewWindow [openInNewWindow]'
115
- });
116
- }, _SpoNavigationNodeSetCommand_initValidators = function _SpoNavigationNodeSetCommand_initValidators() {
117
- this.validators.push(async (args) => {
118
- const isValidSharePointUrl = validation.isValidSharePointUrl(args.options.webUrl);
119
- if (isValidSharePointUrl !== true) {
120
- return isValidSharePointUrl;
121
- }
122
- if (args.options.audienceIds === undefined && args.options.url === undefined && args.options.isExternal === undefined && !args.options.title && args.options.openInNewWindow === undefined) {
123
- return `Please specify at least one property to update.`;
124
- }
125
- if (args.options.audienceIds) {
126
- const audienceIdsSplitted = args.options.audienceIds.split(',');
127
- if (audienceIdsSplitted.length > 10) {
128
- return 'The maximum amount of audienceIds per navigation node exceeded. The maximum amount of audienceIds is 10.';
129
- }
130
- const isValidGUIDArrayResult = validation.isValidGuidArray(args.options.audienceIds);
131
- if (isValidGUIDArrayResult !== true) {
132
- return `The following GUIDs are invalid for the option 'audienceIds': ${isValidGUIDArrayResult}.`;
133
- }
134
- }
135
- return true;
136
- });
137
- };
138
77
  export default new SpoNavigationNodeSetCommand();
139
78
  //# sourceMappingURL=navigation-node-set.js.map
@@ -0,0 +1,53 @@
1
+ import { z } from 'zod';
2
+ import { globalOptionsZod } from '../../../../Command.js';
3
+ import request from '../../../../request.js';
4
+ import { formatting } from '../../../../utils/formatting.js';
5
+ import { urlUtil } from '../../../../utils/urlUtil.js';
6
+ import { validation } from '../../../../utils/validation.js';
7
+ import SpoCommand from '../../../base/SpoCommand.js';
8
+ import commands from '../../commands.js';
9
+ export const options = z.strictObject({
10
+ ...globalOptionsZod.shape,
11
+ webUrl: z.string()
12
+ .refine(url => validation.isValidSharePointUrl(url) === true, {
13
+ error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
14
+ })
15
+ .alias('u'),
16
+ name: z.string().alias('n')
17
+ });
18
+ class SpoPageUnpublishCommand extends SpoCommand {
19
+ get name() {
20
+ return commands.PAGE_UNPUBLISH;
21
+ }
22
+ get description() {
23
+ return 'Unpublishes a modern page';
24
+ }
25
+ get schema() {
26
+ return options;
27
+ }
28
+ async commandAction(logger, args) {
29
+ try {
30
+ let pageName = urlUtil.removeLeadingSlashes(args.options.name);
31
+ if (!pageName.toLowerCase().endsWith('.aspx')) {
32
+ pageName += '.aspx';
33
+ }
34
+ if (this.verbose) {
35
+ await logger.logToStderr(`Unpublishing page ${pageName}...`);
36
+ }
37
+ const filePath = `${urlUtil.getServerRelativeSiteUrl(args.options.webUrl)}/SitePages/${pageName}`;
38
+ const requestOptions = {
39
+ url: `${args.options.webUrl}/_api/web/GetFileByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(filePath)}')/UnPublish`,
40
+ headers: {
41
+ accept: 'application/json;odata=nometadata'
42
+ },
43
+ responseType: 'json'
44
+ };
45
+ await request.post(requestOptions);
46
+ }
47
+ catch (err) {
48
+ this.handleRejectedODataJsonPromise(err);
49
+ }
50
+ }
51
+ }
52
+ export default new SpoPageUnpublishCommand();
53
+ //# sourceMappingURL=page-unpublish.js.map