@pnp/cli-microsoft365 5.5.0-beta.f697eab → 5.5.0

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.
@@ -11,6 +11,11 @@ class SpoCustomActionGetCommand extends SpoCommand_1.default {
11
11
  get description() {
12
12
  return 'Gets details for the specified custom action';
13
13
  }
14
+ optionSets() {
15
+ return [
16
+ ['id', 'title']
17
+ ];
18
+ }
14
19
  getTelemetryProperties(args) {
15
20
  const telemetryProps = super.getTelemetryProperties(args);
16
21
  telemetryProps.scope = args.options.scope || 'All';
@@ -56,14 +61,34 @@ class SpoCustomActionGetCommand extends SpoCommand_1.default {
56
61
  }, (err) => this.handleRejectedPromise(err, logger, cb));
57
62
  }
58
63
  getCustomAction(options) {
64
+ const filter = options.id ?
65
+ `('${encodeURIComponent(options.id)}')` :
66
+ `?$filter=Title eq '${encodeURIComponent(options.title)}'`;
59
67
  const requestOptions = {
60
- url: `${options.url}/_api/${options.scope}/UserCustomActions('${encodeURIComponent(options.id)}')`,
68
+ url: `${options.url}/_api/${options.scope}/UserCustomActions${filter}`,
61
69
  headers: {
62
70
  accept: 'application/json;odata=nometadata'
63
71
  },
64
72
  responseType: 'json'
65
73
  };
66
- return request_1.default.get(requestOptions);
74
+ if (options.id) {
75
+ return request_1.default
76
+ .get(requestOptions)
77
+ .then((res) => {
78
+ return Promise.resolve(res);
79
+ });
80
+ }
81
+ return request_1.default
82
+ .get(requestOptions)
83
+ .then((res) => {
84
+ if (res.value.length === 1) {
85
+ return Promise.resolve(res.value[0]);
86
+ }
87
+ if (res.value.length === 0) {
88
+ return Promise.reject(`No user custom action with title '${options.title}' found`);
89
+ }
90
+ return Promise.reject(`Multiple user custom actions with title '${options.title}' found. Please disambiguate using IDs: ${res.value.map(a => a.Id).join(', ')}`);
91
+ });
67
92
  }
68
93
  /**
69
94
  * Get request with `web` scope is send first.
@@ -104,7 +129,10 @@ class SpoCustomActionGetCommand extends SpoCommand_1.default {
104
129
  options() {
105
130
  const options = [
106
131
  {
107
- option: '-i, --id <id>'
132
+ option: '-i, --id [id]'
133
+ },
134
+ {
135
+ option: '-t, --title [title]'
108
136
  },
109
137
  {
110
138
  option: '-u, --url <url>'
@@ -118,7 +146,7 @@ class SpoCustomActionGetCommand extends SpoCommand_1.default {
118
146
  return options.concat(parentOptions);
119
147
  }
120
148
  validate(args) {
121
- if (utils_1.validation.isValidGuid(args.options.id) === false) {
149
+ if (args.options.id && utils_1.validation.isValidGuid(args.options.id) === false) {
122
150
  return `${args.options.id} is not valid. Custom action id (Guid) expected.`;
123
151
  }
124
152
  if (utils_1.validation.isValidSharePointUrl(args.options.url) !== true) {
@@ -12,6 +12,11 @@ class SpoCustomActionRemoveCommand extends SpoCommand_1.default {
12
12
  get description() {
13
13
  return 'Removes the specified custom action';
14
14
  }
15
+ optionSets() {
16
+ return [
17
+ ['id', 'title']
18
+ ];
19
+ }
15
20
  getTelemetryProperties(args) {
16
21
  const telemetryProps = super.getTelemetryProperties(args);
17
22
  telemetryProps.scope = args.options.scope || 'All';
@@ -54,16 +59,43 @@ class SpoCustomActionRemoveCommand extends SpoCommand_1.default {
54
59
  });
55
60
  }
56
61
  }
57
- removeScopedCustomAction(options) {
58
- const requestOptions = {
59
- url: `${options.url}/_api/${options.scope}/UserCustomActions('${encodeURIComponent(options.id)}')`,
62
+ getCustomActionId(options) {
63
+ if (options.id) {
64
+ return Promise.resolve(options.id);
65
+ }
66
+ const customActionRequestOptions = {
67
+ url: `${options.url}/_api/${options.scope}/UserCustomActions?$filter=Title eq '${encodeURIComponent(options.title)}'`,
60
68
  headers: {
61
- accept: 'application/json;odata=nometadata',
62
- 'X-HTTP-Method': 'DELETE'
69
+ accept: 'application/json;odata=nometadata'
63
70
  },
64
71
  responseType: 'json'
65
72
  };
66
- return request_1.default.post(requestOptions);
73
+ return request_1.default
74
+ .get(customActionRequestOptions)
75
+ .then((res) => {
76
+ if (res.value.length === 1) {
77
+ return Promise.resolve(res.value[0].Id);
78
+ }
79
+ if (res.value.length === 0) {
80
+ return Promise.reject(`No user custom action with title '${options.title}' found`);
81
+ }
82
+ return Promise.reject(`Multiple user custom actions with title '${options.title}' found. Please disambiguate using IDs: ${res.value.map(a => a.Id).join(', ')}`);
83
+ });
84
+ }
85
+ removeScopedCustomAction(options) {
86
+ return this
87
+ .getCustomActionId(options)
88
+ .then((customActionId) => {
89
+ const requestOptions = {
90
+ url: `${options.url}/_api/${options.scope}/UserCustomActions('${encodeURIComponent(customActionId)}')')`,
91
+ headers: {
92
+ accept: 'application/json;odata=nometadata',
93
+ 'X-HTTP-Method': 'DELETE'
94
+ },
95
+ responseType: 'json'
96
+ };
97
+ return request_1.default.post(requestOptions);
98
+ });
67
99
  }
68
100
  /**
69
101
  * Remove request with `web` scope is send first.
@@ -95,7 +127,10 @@ class SpoCustomActionRemoveCommand extends SpoCommand_1.default {
95
127
  options() {
96
128
  const options = [
97
129
  {
98
- option: '-i, --id <id>'
130
+ option: '-i, --id [id]'
131
+ },
132
+ {
133
+ option: '-t, --title [title]'
99
134
  },
100
135
  {
101
136
  option: '-u, --url <url>'
@@ -112,7 +147,7 @@ class SpoCustomActionRemoveCommand extends SpoCommand_1.default {
112
147
  return options.concat(parentOptions);
113
148
  }
114
149
  validate(args) {
115
- if (utils_1.validation.isValidGuid(args.options.id) === false) {
150
+ if (args.options.id && utils_1.validation.isValidGuid(args.options.id) === false) {
116
151
  return `${args.options.id} is not valid. Custom action Id (GUID) expected.`;
117
152
  }
118
153
  if (utils_1.validation.isValidSharePointUrl(args.options.url) !== true) {
@@ -17,10 +17,19 @@ class SpoFieldGetCommand extends SpoCommand_1.default {
17
17
  telemetryProps.listTitle = typeof args.options.listTitle !== 'undefined';
18
18
  telemetryProps.listUrl = typeof args.options.listUrl !== 'undefined';
19
19
  telemetryProps.id = typeof args.options.id !== 'undefined';
20
- telemetryProps.fieldTitle = typeof args.options.fieldTitle !== 'undefined';
20
+ telemetryProps.title = typeof args.options.title !== 'undefined';
21
21
  return telemetryProps;
22
22
  }
23
+ optionSets() {
24
+ return [
25
+ ['id', 'title', 'fieldTitle']
26
+ ];
27
+ }
23
28
  commandAction(logger, args, cb) {
29
+ if (args.options.fieldTitle) {
30
+ args.options.title = args.options.fieldTitle;
31
+ this.warn(logger, `Option 'fieldTitle' is deprecated. Please use 'title' instead.`);
32
+ }
24
33
  let listRestUrl = '';
25
34
  if (args.options.listId) {
26
35
  listRestUrl = `lists(guid'${utils_1.formatting.encodeQueryParameter(args.options.listId)}')/`;
@@ -37,7 +46,7 @@ class SpoFieldGetCommand extends SpoCommand_1.default {
37
46
  fieldRestUrl = `/getbyid('${utils_1.formatting.encodeQueryParameter(args.options.id)}')`;
38
47
  }
39
48
  else {
40
- fieldRestUrl = `/getbyinternalnameortitle('${utils_1.formatting.encodeQueryParameter(args.options.fieldTitle)}')`;
49
+ fieldRestUrl = `/getbyinternalnameortitle('${utils_1.formatting.encodeQueryParameter(args.options.title)}')`;
41
50
  }
42
51
  const requestOptions = {
43
52
  url: `${args.options.webUrl}/_api/web/${listRestUrl}fields${fieldRestUrl}`,
@@ -72,6 +81,9 @@ class SpoFieldGetCommand extends SpoCommand_1.default {
72
81
  },
73
82
  {
74
83
  option: '--fieldTitle [fieldTitle]'
84
+ },
85
+ {
86
+ option: '-t, --title [title]'
75
87
  }
76
88
  ];
77
89
  const parentOptions = super.options();
@@ -82,9 +94,6 @@ class SpoFieldGetCommand extends SpoCommand_1.default {
82
94
  if (isValidSharePointUrl !== true) {
83
95
  return isValidSharePointUrl;
84
96
  }
85
- if (!args.options.id && !args.options.fieldTitle) {
86
- return 'Specify id or fieldTitle, one is required';
87
- }
88
97
  if (args.options.id && !utils_1.validation.isValidGuid(args.options.id)) {
89
98
  return `${args.options.id} is not a valid GUID`;
90
99
  }
@@ -19,11 +19,20 @@ class SpoFieldRemoveCommand extends SpoCommand_1.default {
19
19
  telemetryProps.listUrl = typeof args.options.listUrl !== 'undefined';
20
20
  telemetryProps.id = typeof args.options.id !== 'undefined';
21
21
  telemetryProps.group = typeof args.options.group !== 'undefined';
22
- telemetryProps.fieldTitle = typeof args.options.fieldTitle !== 'undefined';
22
+ telemetryProps.title = typeof args.options.title !== 'undefined';
23
23
  telemetryProps.confirm = (!(!args.options.confirm)).toString();
24
24
  return telemetryProps;
25
25
  }
26
+ optionSets() {
27
+ return [
28
+ ['id', 'title', 'fieldTitle', 'group']
29
+ ];
30
+ }
26
31
  commandAction(logger, args, cb) {
32
+ if (args.options.fieldTitle) {
33
+ args.options.title = args.options.fieldTitle;
34
+ this.warn(logger, `Option 'fieldTitle' is deprecated. Please use 'title' instead.`);
35
+ }
27
36
  let messageEnd;
28
37
  if (args.options.listId || args.options.listTitle) {
29
38
  messageEnd = `in list ${args.options.listId || args.options.listTitle}`;
@@ -31,16 +40,16 @@ class SpoFieldRemoveCommand extends SpoCommand_1.default {
31
40
  else {
32
41
  messageEnd = `in site ${args.options.webUrl}`;
33
42
  }
34
- const removeField = (listRestUrl, fieldId, fieldTitle) => {
43
+ const removeField = (listRestUrl, fieldId, title) => {
35
44
  if (this.verbose) {
36
- logger.logToStderr(`Removing field ${fieldId || fieldTitle} ${messageEnd}...`);
45
+ logger.logToStderr(`Removing field ${fieldId || title} ${messageEnd}...`);
37
46
  }
38
47
  let fieldRestUrl = '';
39
48
  if (fieldId) {
40
49
  fieldRestUrl = `/getbyid('${utils_1.formatting.encodeQueryParameter(fieldId)}')`;
41
50
  }
42
51
  else {
43
- fieldRestUrl = `/getbyinternalnameortitle('${utils_1.formatting.encodeQueryParameter(fieldTitle)}')`;
52
+ fieldRestUrl = `/getbyinternalnameortitle('${utils_1.formatting.encodeQueryParameter(title)}')`;
44
53
  }
45
54
  const requestOptions = {
46
55
  url: `${args.options.webUrl}/_api/web/${listRestUrl}fields${fieldRestUrl}`,
@@ -97,7 +106,7 @@ class SpoFieldRemoveCommand extends SpoCommand_1.default {
97
106
  }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
98
107
  }
99
108
  else {
100
- removeField(listRestUrl, args.options.id, args.options.fieldTitle)
109
+ removeField(listRestUrl, args.options.id, args.options.title)
101
110
  .then(() => {
102
111
  // REST post call doesn't return anything
103
112
  cb();
@@ -108,7 +117,7 @@ class SpoFieldRemoveCommand extends SpoCommand_1.default {
108
117
  prepareRemoval();
109
118
  }
110
119
  else {
111
- const confirmMessage = `Are you sure you want to remove the ${args.options.group ? 'fields' : 'field'} ${args.options.id || args.options.fieldTitle || 'from group ' + args.options.group} ${messageEnd}?`;
120
+ const confirmMessage = `Are you sure you want to remove the ${args.options.group ? 'fields' : 'field'} ${args.options.id || args.options.title || 'from group ' + args.options.group} ${messageEnd}?`;
112
121
  cli_1.Cli.prompt({
113
122
  type: 'confirm',
114
123
  name: 'continue',
@@ -142,7 +151,10 @@ class SpoFieldRemoveCommand extends SpoCommand_1.default {
142
151
  option: '-i, --id [id]'
143
152
  },
144
153
  {
145
- option: '-t, --fieldTitle [fieldTitle]'
154
+ option: '--fieldTitle [fieldTitle]'
155
+ },
156
+ {
157
+ option: '-t, --title [title]'
146
158
  },
147
159
  {
148
160
  option: '-g, --group [group]'
@@ -159,9 +171,6 @@ class SpoFieldRemoveCommand extends SpoCommand_1.default {
159
171
  if (isValidSharePointUrl !== true) {
160
172
  return isValidSharePointUrl;
161
173
  }
162
- if (!args.options.id && !args.options.fieldTitle && !args.options.group) {
163
- return 'Specify id, fieldTitle, or group. One is required';
164
- }
165
174
  if (args.options.id && !utils_1.validation.isValidGuid(args.options.id)) {
166
175
  return `${args.options.id} is not a valid GUID`;
167
176
  }
@@ -29,6 +29,7 @@ class SpoSiteClassicSetCommand extends SpoCommand_1.default {
29
29
  return telemetryProps;
30
30
  }
31
31
  commandAction(logger, args, cb) {
32
+ this.showDeprecationWarning(logger, commands_1.default.SITE_CLASSIC_SET, commands_1.default.SITE_SET);
32
33
  this.dots = '';
33
34
  utils_1.spo
34
35
  .getTenantId(logger, this.debug)