@pnp/cli-microsoft365 5.7.0 → 5.8.0-beta.119711d

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 (530) hide show
  1. package/dist/Command.js +48 -35
  2. package/dist/cli/Cli.js +31 -25
  3. package/dist/m365/aad/commands/app/app-add.js +30 -30
  4. package/dist/m365/aad/commands/app/app-get.js +16 -20
  5. package/dist/m365/aad/commands/app/app-remove.js +38 -46
  6. package/dist/m365/aad/commands/app/app-role-add.js +34 -36
  7. package/dist/m365/aad/commands/app/app-role-list.js +15 -23
  8. package/dist/m365/aad/commands/app/app-role-remove.js +27 -44
  9. package/dist/m365/aad/commands/app/app-set.js +16 -18
  10. package/dist/m365/aad/commands/approleassignment/approleassignment-add.js +93 -101
  11. package/dist/m365/aad/commands/approleassignment/approleassignment-list.js +42 -49
  12. package/dist/m365/aad/commands/approleassignment/approleassignment-remove.js +93 -99
  13. package/dist/m365/aad/commands/group/group-list.js +35 -23
  14. package/dist/m365/aad/commands/groupsetting/groupsetting-add.js +33 -32
  15. package/dist/m365/aad/commands/groupsetting/groupsetting-get.js +17 -14
  16. package/dist/m365/aad/commands/groupsetting/groupsetting-list.js +19 -7
  17. package/dist/m365/aad/commands/groupsetting/groupsetting-remove.js +30 -29
  18. package/dist/m365/aad/commands/groupsetting/groupsetting-set.js +33 -30
  19. package/dist/m365/aad/commands/groupsettingtemplate/groupsettingtemplate-get.js +18 -20
  20. package/dist/m365/aad/commands/groupsettingtemplate/groupsettingtemplate-list.js +19 -7
  21. package/dist/m365/aad/commands/o365group/o365group-add.js +85 -96
  22. package/dist/m365/aad/commands/o365group/o365group-conversation-list.js +10 -7
  23. package/dist/m365/aad/commands/o365group/o365group-conversation-post-list.js +15 -18
  24. package/dist/m365/aad/commands/o365group/o365group-get.js +20 -25
  25. package/dist/m365/aad/commands/o365group/o365group-list.js +38 -43
  26. package/dist/m365/aad/commands/o365group/o365group-recyclebinitem-clear.js +31 -19
  27. package/dist/m365/aad/commands/o365group/o365group-recyclebinitem-list.js +24 -12
  28. package/dist/m365/aad/commands/o365group/o365group-recyclebinitem-remove.js +30 -33
  29. package/dist/m365/aad/commands/o365group/o365group-recyclebinitem-restore.js +21 -18
  30. package/dist/m365/aad/commands/o365group/o365group-remove.js +38 -40
  31. package/dist/m365/aad/commands/o365group/o365group-renew.js +17 -12
  32. package/dist/m365/aad/commands/o365group/o365group-set.js +96 -114
  33. package/dist/m365/aad/commands/o365group/o365group-teamify.js +35 -35
  34. package/dist/m365/aad/commands/o365group/o365group-user-add.js +31 -31
  35. package/dist/m365/aad/commands/o365group/o365group-user-list.js +15 -17
  36. package/dist/m365/aad/commands/o365group/o365group-user-remove.js +61 -67
  37. package/dist/m365/aad/commands/o365group/o365group-user-set.js +63 -67
  38. package/dist/m365/aad/commands/oauth2grant/oauth2grant-add.js +25 -20
  39. package/dist/m365/aad/commands/oauth2grant/oauth2grant-list.js +21 -18
  40. package/dist/m365/aad/commands/oauth2grant/oauth2grant-remove.js +41 -31
  41. package/dist/m365/aad/commands/oauth2grant/oauth2grant-set.js +30 -16
  42. package/dist/m365/aad/commands/policy/policy-list.js +22 -23
  43. package/dist/m365/aad/commands/siteclassification/siteclassification-disable.js +60 -52
  44. package/dist/m365/aad/commands/siteclassification/siteclassification-enable.js +84 -72
  45. package/dist/m365/aad/commands/siteclassification/siteclassification-get.js +66 -57
  46. package/dist/m365/aad/commands/siteclassification/siteclassification-set.js +96 -93
  47. package/dist/m365/aad/commands/sp/sp-add.js +26 -29
  48. package/dist/m365/aad/commands/sp/sp-get.js +26 -29
  49. package/dist/m365/aad/commands/user/user-get.js +41 -46
  50. package/dist/m365/aad/commands/user/user-hibp.js +21 -22
  51. package/dist/m365/aad/commands/user/user-list.js +35 -14
  52. package/dist/m365/aad/commands/user/user-password-validate.js +29 -17
  53. package/dist/m365/aad/commands/user/user-set.js +22 -20
  54. package/dist/m365/aad/commands/user/user-signin-list.js +24 -21
  55. package/dist/m365/adaptivecard/commands/adaptivecard-send.js +39 -37
  56. package/dist/m365/app/commands/app-get.js +27 -15
  57. package/dist/m365/app/commands/app-open.js +18 -3
  58. package/dist/m365/app/commands/permission/permission-list.js +17 -15
  59. package/dist/m365/base/AnonymousCommand.js +14 -3
  60. package/dist/m365/base/AppCommand.js +51 -44
  61. package/dist/m365/base/DateAndPeriodBasedReport.js +7 -5
  62. package/dist/m365/base/PeriodBasedReport.js +23 -16
  63. package/dist/m365/base/SpoCommand.js +13 -9
  64. package/dist/m365/base/YammerCommand.js +4 -4
  65. package/dist/m365/booking/commands/business/business-get.js +27 -17
  66. package/dist/m365/booking/commands/business/business-list.js +20 -11
  67. package/dist/m365/cli/commands/cli-consent.js +15 -12
  68. package/dist/m365/cli/commands/cli-doctor.js +35 -25
  69. package/dist/m365/cli/commands/cli-issue.js +15 -15
  70. package/dist/m365/cli/commands/cli-reconsent.js +30 -18
  71. package/dist/m365/cli/commands/completion/completion-clink-update.js +13 -3
  72. package/dist/m365/cli/commands/completion/completion-pwsh-setup.js +47 -38
  73. package/dist/m365/cli/commands/completion/completion-pwsh-update.js +16 -6
  74. package/dist/m365/cli/commands/completion/completion-sh-setup.js +21 -11
  75. package/dist/m365/cli/commands/completion/completion-sh-update.js +16 -6
  76. package/dist/m365/cli/commands/config/config-get.js +4 -3
  77. package/dist/m365/cli/commands/config/config-reset.js +9 -8
  78. package/dist/m365/cli/commands/config/config-set.js +20 -19
  79. package/dist/m365/commands/commands.js +1 -0
  80. package/dist/m365/commands/login.js +66 -63
  81. package/dist/m365/commands/logout.js +34 -23
  82. package/dist/m365/commands/request.js +150 -0
  83. package/dist/m365/commands/status.js +49 -27
  84. package/dist/m365/commands/version.js +13 -3
  85. package/dist/m365/file/commands/convert/convert-pdf.js +58 -53
  86. package/dist/m365/file/commands/file-add.js +14 -9
  87. package/dist/m365/file/commands/file-list.js +27 -30
  88. package/dist/m365/flow/commands/environment/environment-get.js +34 -22
  89. package/dist/m365/flow/commands/environment/environment-list.js +33 -21
  90. package/dist/m365/flow/commands/flow-disable.js +28 -14
  91. package/dist/m365/flow/commands/flow-enable.js +28 -14
  92. package/dist/m365/flow/commands/flow-export.js +102 -102
  93. package/dist/m365/flow/commands/flow-get.js +33 -21
  94. package/dist/m365/flow/commands/flow-list.js +28 -16
  95. package/dist/m365/flow/commands/flow-remove.js +38 -42
  96. package/dist/m365/flow/commands/run/run-cancel.js +32 -31
  97. package/dist/m365/flow/commands/run/run-get.js +33 -21
  98. package/dist/m365/flow/commands/run/run-list.js +31 -19
  99. package/dist/m365/flow/commands/run/run-resubmit.js +36 -37
  100. package/dist/m365/graph/Changelog.js +3 -0
  101. package/dist/m365/graph/commands/changelog/changelog-list.js +163 -0
  102. package/dist/m365/graph/commands/schemaextension/schemaextension-add.js +30 -27
  103. package/dist/m365/graph/commands/schemaextension/schemaextension-get.js +30 -17
  104. package/dist/m365/graph/commands/schemaextension/schemaextension-list.js +38 -34
  105. package/dist/m365/graph/commands/schemaextension/schemaextension-remove.js +42 -31
  106. package/dist/m365/graph/commands/schemaextension/schemaextension-set.js +57 -54
  107. package/dist/m365/graph/commands/subscription/subscription-add.js +28 -25
  108. package/dist/m365/graph/commands.js +1 -0
  109. package/dist/m365/onedrive/commands/onedrive-list.js +23 -13
  110. package/dist/m365/onenote/commands/notebook/notebook-list.js +139 -0
  111. package/dist/m365/onenote/commands.js +7 -0
  112. package/dist/m365/outlook/commands/mail/mail-send.js +53 -30
  113. package/dist/m365/outlook/commands/message/message-list.js +16 -25
  114. package/dist/m365/outlook/commands/message/message-move.js +28 -47
  115. package/dist/m365/outlook/commands/room/room-list.js +23 -11
  116. package/dist/m365/outlook/commands/roomlist/roomlist-list.js +19 -7
  117. package/dist/m365/pa/commands/app/app-get.js +45 -49
  118. package/dist/m365/pa/commands/app/app-list.js +19 -16
  119. package/dist/m365/pa/commands/app/app-remove.js +38 -38
  120. package/dist/m365/pa/commands/connector/connector-export.js +102 -104
  121. package/dist/m365/pa/commands/connector/connector-list.js +28 -16
  122. package/dist/m365/pa/commands/environment/environment-get.js +34 -22
  123. package/dist/m365/pa/commands/environment/environment-list.js +33 -21
  124. package/dist/m365/pa/commands/pcf/pcf-init.js +35 -34
  125. package/dist/m365/pa/commands/solution/solution-init.js +48 -47
  126. package/dist/m365/pa/commands/solution/solution-reference-add.js +15 -14
  127. package/dist/m365/planner/commands/bucket/bucket-add.js +35 -37
  128. package/dist/m365/planner/commands/bucket/bucket-get.js +19 -16
  129. package/dist/m365/planner/commands/bucket/bucket-list.js +23 -23
  130. package/dist/m365/planner/commands/bucket/bucket-remove.js +39 -40
  131. package/dist/m365/planner/commands/bucket/bucket-set.js +32 -29
  132. package/dist/m365/planner/commands/plan/plan-add.js +31 -33
  133. package/dist/m365/planner/commands/plan/plan-get.js +31 -32
  134. package/dist/m365/planner/commands/plan/plan-list.js +20 -20
  135. package/dist/m365/planner/commands/plan/plan-remove.js +34 -37
  136. package/dist/m365/planner/commands/task/task-add.js +47 -61
  137. package/dist/m365/planner/commands/task/task-checklistitem-add.js +47 -37
  138. package/dist/m365/planner/commands/task/task-checklistitem-list.js +35 -21
  139. package/dist/m365/planner/commands/task/task-checklistitem-remove.js +51 -41
  140. package/dist/m365/planner/commands/task/task-get.js +32 -22
  141. package/dist/m365/planner/commands/task/task-list.js +48 -58
  142. package/dist/m365/planner/commands/task/task-reference-add.js +24 -23
  143. package/dist/m365/planner/commands/task/task-reference-list.js +30 -18
  144. package/dist/m365/planner/commands/task/task-reference-remove.js +39 -40
  145. package/dist/m365/planner/commands/task/task-remove.js +31 -32
  146. package/dist/m365/planner/commands/task/task-set.js +34 -39
  147. package/dist/m365/planner/commands/tenant/tenant-settings-list.js +26 -14
  148. package/dist/m365/planner/commands/tenant/tenant-settings-set.js +25 -22
  149. package/dist/m365/pp/commands/environment/environment-list.js +41 -29
  150. package/dist/m365/pp/commands/gateway/gateway-list.js +29 -17
  151. package/dist/m365/pp/commands/managementapp/managementapp-add.js +23 -29
  152. package/dist/m365/pp/commands/managementapp/managementapp-list.js +20 -8
  153. package/dist/m365/search/commands/externalconnection/externalconnection-add.js +29 -24
  154. package/dist/m365/search/commands/externalconnection/externalconnection-get.js +37 -28
  155. package/dist/m365/search/commands/externalconnection/externalconnection-list.js +19 -7
  156. package/dist/m365/search/commands/externalconnection/externalconnection-remove.js +39 -32
  157. package/dist/m365/spfx/commands/package/package-generate.js +104 -97
  158. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.16.0-beta.1.js +23 -0
  159. package/dist/m365/spfx/commands/project/project-doctor.js +101 -103
  160. package/dist/m365/spfx/commands/project/project-externalize.js +45 -38
  161. package/dist/m365/spfx/commands/project/project-rename.js +38 -30
  162. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010008_YORC_nodeVersion.js +47 -0
  163. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN021003_PKG_engines_node.js +48 -0
  164. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.16.0-beta.1.js +61 -0
  165. package/dist/m365/spfx/commands/project/project-upgrade.js +180 -183
  166. package/dist/m365/spfx/commands/spfx-doctor.js +132 -126
  167. package/dist/m365/spo/commands/app/app-add.js +31 -32
  168. package/dist/m365/spo/commands/app/app-deploy.js +41 -45
  169. package/dist/m365/spo/commands/app/app-get.js +43 -47
  170. package/dist/m365/spo/commands/app/app-install.js +18 -13
  171. package/dist/m365/spo/commands/app/app-instance-list.js +25 -21
  172. package/dist/m365/spo/commands/app/app-list.js +29 -32
  173. package/dist/m365/spo/commands/app/app-remove.js +33 -36
  174. package/dist/m365/spo/commands/app/app-retract.js +33 -36
  175. package/dist/m365/spo/commands/app/app-teamspackage-download.js +42 -43
  176. package/dist/m365/spo/commands/app/app-uninstall.js +31 -30
  177. package/dist/m365/spo/commands/app/app-upgrade.js +18 -13
  178. package/dist/m365/spo/commands/apppage/apppage-add.js +38 -39
  179. package/dist/m365/spo/commands/apppage/apppage-set.js +20 -15
  180. package/dist/m365/spo/commands/cdn/cdn-get.js +35 -41
  181. package/dist/m365/spo/commands/cdn/cdn-origin-add.js +29 -37
  182. package/dist/m365/spo/commands/cdn/cdn-origin-list.js +33 -39
  183. package/dist/m365/spo/commands/cdn/cdn-origin-remove.js +43 -57
  184. package/dist/m365/spo/commands/cdn/cdn-policy-list.js +41 -48
  185. package/dist/m365/spo/commands/cdn/cdn-policy-set.js +36 -45
  186. package/dist/m365/spo/commands/cdn/cdn-set.js +63 -67
  187. package/dist/m365/spo/commands/contenttype/contenttype-add.js +48 -53
  188. package/dist/m365/spo/commands/contenttype/contenttype-field-remove.js +94 -112
  189. package/dist/m365/spo/commands/contenttype/contenttype-field-set.js +120 -146
  190. package/dist/m365/spo/commands/contenttype/contenttype-get.js +39 -41
  191. package/dist/m365/spo/commands/contenttype/contenttype-list.js +21 -18
  192. package/dist/m365/spo/commands/contenttype/contenttype-remove.js +67 -80
  193. package/dist/m365/spo/commands/contenttypehub/contenttypehub-get.js +50 -47
  194. package/dist/m365/spo/commands/customaction/customaction-add.js +43 -40
  195. package/dist/m365/spo/commands/customaction/customaction-clear.js +27 -25
  196. package/dist/m365/spo/commands/customaction/customaction-get.js +40 -35
  197. package/dist/m365/spo/commands/customaction/customaction-list.js +28 -23
  198. package/dist/m365/spo/commands/customaction/customaction-remove.js +32 -31
  199. package/dist/m365/spo/commands/customaction/customaction-set.js +21 -16
  200. package/dist/m365/spo/commands/eventreceiver/eventreceiver-get.js +42 -39
  201. package/dist/m365/spo/commands/eventreceiver/eventreceiver-list.js +35 -32
  202. package/dist/m365/spo/commands/externaluser/externaluser-list.js +51 -56
  203. package/dist/m365/spo/commands/feature/feature-disable.js +26 -21
  204. package/dist/m365/spo/commands/feature/feature-enable.js +26 -21
  205. package/dist/m365/spo/commands/feature/feature-list.js +23 -20
  206. package/dist/m365/spo/commands/field/field-add.js +25 -24
  207. package/dist/m365/spo/commands/field/field-get.js +39 -36
  208. package/dist/m365/spo/commands/field/field-list.js +28 -25
  209. package/dist/m365/spo/commands/field/field-remove.js +83 -86
  210. package/dist/m365/spo/commands/field/field-set.js +64 -70
  211. package/dist/m365/spo/commands/file/file-add.js +153 -175
  212. package/dist/m365/spo/commands/file/file-checkin.js +40 -38
  213. package/dist/m365/spo/commands/file/file-checkout.js +27 -25
  214. package/dist/m365/spo/commands/file/file-copy.js +61 -63
  215. package/dist/m365/spo/commands/file/file-get.js +68 -73
  216. package/dist/m365/spo/commands/file/file-list.js +13 -8
  217. package/dist/m365/spo/commands/file/file-move.js +60 -62
  218. package/dist/m365/spo/commands/file/file-remove.js +58 -63
  219. package/dist/m365/spo/commands/file/file-rename.js +29 -31
  220. package/dist/m365/spo/commands/file/file-sharinginfo-get.js +49 -50
  221. package/dist/m365/spo/commands/folder/folder-add.js +26 -23
  222. package/dist/m365/spo/commands/folder/folder-copy.js +45 -42
  223. package/dist/m365/spo/commands/folder/folder-get.js +23 -23
  224. package/dist/m365/spo/commands/folder/folder-list.js +22 -19
  225. package/dist/m365/spo/commands/folder/folder-move.js +46 -43
  226. package/dist/m365/spo/commands/folder/folder-remove.js +40 -39
  227. package/dist/m365/spo/commands/folder/folder-rename.js +30 -36
  228. package/dist/m365/spo/commands/group/group-add.js +25 -22
  229. package/dist/m365/spo/commands/group/group-get.js +40 -37
  230. package/dist/m365/spo/commands/group/group-list.js +21 -18
  231. package/dist/m365/spo/commands/group/group-remove.js +50 -56
  232. package/dist/m365/spo/commands/group/group-set.js +26 -21
  233. package/dist/m365/spo/commands/group/group-user-add.js +34 -47
  234. package/dist/m365/spo/commands/group/group-user-list.js +27 -27
  235. package/dist/m365/spo/commands/group/group-user-remove.js +43 -47
  236. package/dist/m365/spo/commands/hidedefaultthemes/hidedefaultthemes-get.js +29 -19
  237. package/dist/m365/spo/commands/hidedefaultthemes/hidedefaultthemes-set.js +22 -19
  238. package/dist/m365/spo/commands/homesite/homesite-get.js +28 -18
  239. package/dist/m365/spo/commands/homesite/homesite-remove.js +48 -47
  240. package/dist/m365/spo/commands/homesite/homesite-set.js +24 -29
  241. package/dist/m365/spo/commands/hubsite/hubsite-connect.js +18 -15
  242. package/dist/m365/spo/commands/hubsite/hubsite-data-get.js +25 -22
  243. package/dist/m365/spo/commands/hubsite/hubsite-disconnect.js +34 -35
  244. package/dist/m365/spo/commands/hubsite/hubsite-get.js +18 -32
  245. package/dist/m365/spo/commands/hubsite/hubsite-list.js +64 -62
  246. package/dist/m365/spo/commands/hubsite/hubsite-register.js +19 -18
  247. package/dist/m365/spo/commands/hubsite/hubsite-rights-grant.js +29 -34
  248. package/dist/m365/spo/commands/hubsite/hubsite-rights-revoke.js +43 -52
  249. package/dist/m365/spo/commands/hubsite/hubsite-set.js +34 -39
  250. package/dist/m365/spo/commands/hubsite/hubsite-theme-sync.js +19 -14
  251. package/dist/m365/spo/commands/hubsite/hubsite-unregister.js +32 -33
  252. package/dist/m365/spo/commands/knowledgehub/knowledgehub-get.js +34 -31
  253. package/dist/m365/spo/commands/knowledgehub/knowledgehub-remove.js +50 -51
  254. package/dist/m365/spo/commands/knowledgehub/knowledgehub-set.js +25 -31
  255. package/dist/m365/spo/commands/list/list-add.js +23 -20
  256. package/dist/m365/spo/commands/list/list-contenttype-add.js +34 -34
  257. package/dist/m365/spo/commands/list/list-contenttype-default-set.js +60 -64
  258. package/dist/m365/spo/commands/list/list-contenttype-list.js +33 -33
  259. package/dist/m365/spo/commands/list/list-contenttype-remove.js +45 -50
  260. package/dist/m365/spo/commands/list/list-get.js +37 -37
  261. package/dist/m365/spo/commands/list/list-label-get.js +50 -55
  262. package/dist/m365/spo/commands/list/list-label-set.js +50 -48
  263. package/dist/m365/spo/commands/list/list-list.js +25 -22
  264. package/dist/m365/spo/commands/list/list-remove.js +45 -50
  265. package/dist/m365/spo/commands/list/list-roleassignment-add.js +44 -36
  266. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +63 -36
  267. package/dist/m365/spo/commands/list/list-roleinheritance-break.js +32 -27
  268. package/dist/m365/spo/commands/list/list-roleinheritance-reset.js +28 -23
  269. package/dist/m365/spo/commands/list/list-set.js +25 -22
  270. package/dist/m365/spo/commands/list/list-sitescript-get.js +53 -59
  271. package/dist/m365/spo/commands/list/list-view-add.js +29 -26
  272. package/dist/m365/spo/commands/list/list-view-field-add.js +51 -67
  273. package/dist/m365/spo/commands/list/list-view-field-remove.js +44 -62
  274. package/dist/m365/spo/commands/list/list-view-field-set.js +32 -44
  275. package/dist/m365/spo/commands/list/list-view-get.js +34 -37
  276. package/dist/m365/spo/commands/list/list-view-list.js +32 -32
  277. package/dist/m365/spo/commands/list/list-view-remove.js +44 -54
  278. package/dist/m365/spo/commands/list/list-view-set.js +29 -35
  279. package/dist/m365/spo/commands/list/list-webhook-add.js +43 -45
  280. package/dist/m365/spo/commands/list/list-webhook-get.js +33 -35
  281. package/dist/m365/spo/commands/list/list-webhook-list.js +47 -44
  282. package/dist/m365/spo/commands/list/list-webhook-remove.js +45 -51
  283. package/dist/m365/spo/commands/list/list-webhook-set.js +39 -41
  284. package/dist/m365/spo/commands/listitem/listitem-add.js +104 -116
  285. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +32 -32
  286. package/dist/m365/spo/commands/listitem/listitem-get.js +32 -32
  287. package/dist/m365/spo/commands/listitem/listitem-isrecord.js +67 -73
  288. package/dist/m365/spo/commands/listitem/listitem-list.js +63 -70
  289. package/dist/m365/spo/commands/listitem/listitem-record-declare.js +53 -58
  290. package/dist/m365/spo/commands/listitem/listitem-record-undeclare.js +53 -58
  291. package/dist/m365/spo/commands/listitem/listitem-remove.js +50 -54
  292. package/dist/m365/spo/commands/listitem/listitem-roleassignment-remove.js +204 -0
  293. package/dist/m365/spo/commands/listitem/listitem-roleinheritance-break.js +32 -27
  294. package/dist/m365/spo/commands/listitem/listitem-roleinheritance-reset.js +25 -20
  295. package/dist/m365/spo/commands/listitem/listitem-set.js +145 -167
  296. package/dist/m365/spo/commands/mail/mail-send.js +48 -43
  297. package/dist/m365/spo/commands/navigation/navigation-node-add.js +29 -26
  298. package/dist/m365/spo/commands/navigation/navigation-node-list.js +26 -23
  299. package/dist/m365/spo/commands/navigation/navigation-node-remove.js +34 -35
  300. package/dist/m365/spo/commands/orgassetslibrary/orgassetslibrary-add.js +26 -30
  301. package/dist/m365/spo/commands/orgassetslibrary/orgassetslibrary-list.js +48 -44
  302. package/dist/m365/spo/commands/orgassetslibrary/orgassetslibrary-remove.js +48 -48
  303. package/dist/m365/spo/commands/orgnewssite/orgnewssite-list.js +34 -30
  304. package/dist/m365/spo/commands/orgnewssite/orgnewssite-remove.js +36 -47
  305. package/dist/m365/spo/commands/orgnewssite/orgnewssite-set.js +22 -27
  306. package/dist/m365/spo/commands/page/page-add.js +193 -216
  307. package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js +183 -186
  308. package/dist/m365/spo/commands/page/page-column-get.js +23 -20
  309. package/dist/m365/spo/commands/page/page-column-list.js +18 -15
  310. package/dist/m365/spo/commands/page/page-control-get.js +36 -33
  311. package/dist/m365/spo/commands/page/page-control-list.js +33 -30
  312. package/dist/m365/spo/commands/page/page-control-set.js +97 -97
  313. package/dist/m365/spo/commands/page/page-copy.js +51 -51
  314. package/dist/m365/spo/commands/page/page-get.js +49 -51
  315. package/dist/m365/spo/commands/page/page-header-set.js +228 -232
  316. package/dist/m365/spo/commands/page/page-list.js +40 -39
  317. package/dist/m365/spo/commands/page/page-remove.js +43 -44
  318. package/dist/m365/spo/commands/page/page-section-add.js +66 -68
  319. package/dist/m365/spo/commands/page/page-section-get.js +14 -11
  320. package/dist/m365/spo/commands/page/page-section-list.js +23 -20
  321. package/dist/m365/spo/commands/page/page-set.js +215 -236
  322. package/dist/m365/spo/commands/page/page-template-list.js +24 -25
  323. package/dist/m365/spo/commands/page/page-text-add.js +40 -40
  324. package/dist/m365/spo/commands/propertybag/propertybag-get.js +24 -22
  325. package/dist/m365/spo/commands/propertybag/propertybag-list.js +19 -17
  326. package/dist/m365/spo/commands/propertybag/propertybag-remove.js +30 -36
  327. package/dist/m365/spo/commands/propertybag/propertybag-set.js +22 -27
  328. package/dist/m365/spo/commands/roledefinition/roledefinition-add.js +117 -0
  329. package/dist/m365/spo/commands/roledefinition/roledefinition-get.js +25 -22
  330. package/dist/m365/spo/commands/roledefinition/roledefinition-list.js +20 -17
  331. package/dist/m365/spo/commands/roledefinition/roledefinition-remove.js +35 -34
  332. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-grant-add.js +38 -34
  333. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-grant-list.js +42 -38
  334. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-grant-revoke.js +33 -29
  335. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-permissionrequest-approve.js +29 -34
  336. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-permissionrequest-deny.js +24 -29
  337. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-permissionrequest-list.js +44 -40
  338. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-set.js +45 -54
  339. package/dist/m365/spo/commands/site/site-add.js +177 -189
  340. package/dist/m365/spo/commands/site/site-appcatalog-add.js +29 -34
  341. package/dist/m365/spo/commands/site/site-appcatalog-remove.js +29 -34
  342. package/dist/m365/spo/commands/site/site-apppermission-add.js +26 -28
  343. package/dist/m365/spo/commands/site/site-apppermission-get.js +19 -16
  344. package/dist/m365/spo/commands/site/site-apppermission-list.js +15 -17
  345. package/dist/m365/spo/commands/site/site-apppermission-remove.js +33 -44
  346. package/dist/m365/spo/commands/site/site-apppermission-set.js +27 -29
  347. package/dist/m365/spo/commands/site/site-chrome-set.js +50 -45
  348. package/dist/m365/spo/commands/site/site-classic-add.js +66 -82
  349. package/dist/m365/spo/commands/site/site-classic-list.js +27 -19
  350. package/dist/m365/spo/commands/site/site-classic-set.js +168 -186
  351. package/dist/m365/spo/commands/site/site-commsite-enable.js +25 -30
  352. package/dist/m365/spo/commands/site/site-ensure.js +38 -28
  353. package/dist/m365/spo/commands/site/site-get.js +17 -14
  354. package/dist/m365/spo/commands/site/site-groupify.js +35 -32
  355. package/dist/m365/spo/commands/site/site-inplacerecordsmanagement-set.js +24 -19
  356. package/dist/m365/spo/commands/site/site-list.js +17 -18
  357. package/dist/m365/spo/commands/site/site-recyclebinitem-list.js +27 -24
  358. package/dist/m365/spo/commands/site/site-recyclebinitem-restore.js +31 -24
  359. package/dist/m365/spo/commands/site/site-remove.js +49 -58
  360. package/dist/m365/spo/commands/site/site-rename.js +65 -76
  361. package/dist/m365/spo/commands/site/site-set.js +26 -32
  362. package/dist/m365/spo/commands/sitedesign/sitedesign-add.js +37 -40
  363. package/dist/m365/spo/commands/sitedesign/sitedesign-apply.js +27 -26
  364. package/dist/m365/spo/commands/sitedesign/sitedesign-get.js +23 -26
  365. package/dist/m365/spo/commands/sitedesign/sitedesign-list.js +27 -17
  366. package/dist/m365/spo/commands/sitedesign/sitedesign-remove.js +34 -39
  367. package/dist/m365/spo/commands/sitedesign/sitedesign-rights-grant.js +26 -27
  368. package/dist/m365/spo/commands/sitedesign/sitedesign-rights-list.js +25 -28
  369. package/dist/m365/spo/commands/sitedesign/sitedesign-rights-revoke.js +37 -42
  370. package/dist/m365/spo/commands/sitedesign/sitedesign-run-list.js +27 -23
  371. package/dist/m365/spo/commands/sitedesign/sitedesign-run-status-get.js +22 -18
  372. package/dist/m365/spo/commands/sitedesign/sitedesign-set.js +49 -48
  373. package/dist/m365/spo/commands/sitedesign/sitedesign-task-get.js +22 -21
  374. package/dist/m365/spo/commands/sitedesign/sitedesign-task-list.js +17 -13
  375. package/dist/m365/spo/commands/sitedesign/sitedesign-task-remove.js +33 -34
  376. package/dist/m365/spo/commands/sitescript/sitescript-add.js +22 -25
  377. package/dist/m365/spo/commands/sitescript/sitescript-get.js +22 -25
  378. package/dist/m365/spo/commands/sitescript/sitescript-list.js +30 -24
  379. package/dist/m365/spo/commands/sitescript/sitescript-remove.js +34 -39
  380. package/dist/m365/spo/commands/sitescript/sitescript-set.js +35 -38
  381. package/dist/m365/spo/commands/spo-get.js +16 -6
  382. package/dist/m365/spo/commands/spo-search.js +19 -20
  383. package/dist/m365/spo/commands/spo-set.js +9 -7
  384. package/dist/m365/spo/commands/storageentity/storageentity-get.js +36 -26
  385. package/dist/m365/spo/commands/storageentity/storageentity-list.js +34 -36
  386. package/dist/m365/spo/commands/storageentity/storageentity-remove.js +38 -48
  387. package/dist/m365/spo/commands/storageentity/storageentity-set.js +29 -34
  388. package/dist/m365/spo/commands/tenant/tenant-appcatalog-add.js +15 -16
  389. package/dist/m365/spo/commands/tenant/tenant-appcatalogurl-get.js +31 -21
  390. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-list.js +38 -34
  391. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-remove.js +51 -59
  392. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +21 -20
  393. package/dist/m365/spo/commands/tenant/tenant-settings-list.js +56 -52
  394. package/dist/m365/spo/commands/tenant/tenant-settings-set.js +54 -65
  395. package/dist/m365/spo/commands/term/term-add.js +95 -105
  396. package/dist/m365/spo/commands/term/term-get.js +47 -56
  397. package/dist/m365/spo/commands/term/term-group-add.js +70 -79
  398. package/dist/m365/spo/commands/term/term-group-get.js +36 -44
  399. package/dist/m365/spo/commands/term/term-group-list.js +42 -38
  400. package/dist/m365/spo/commands/term/term-list.js +39 -53
  401. package/dist/m365/spo/commands/term/term-set-add.js +83 -93
  402. package/dist/m365/spo/commands/term/term-set-get.js +37 -51
  403. package/dist/m365/spo/commands/term/term-set-list.js +39 -47
  404. package/dist/m365/spo/commands/theme/theme-apply.js +52 -58
  405. package/dist/m365/spo/commands/theme/theme-get.js +37 -33
  406. package/dist/m365/spo/commands/theme/theme-list.js +35 -25
  407. package/dist/m365/spo/commands/theme/theme-remove.js +45 -37
  408. package/dist/m365/spo/commands/theme/theme-set.js +29 -32
  409. package/dist/m365/spo/commands/user/user-get.js +35 -37
  410. package/dist/m365/spo/commands/user/user-list.js +23 -20
  411. package/dist/m365/spo/commands/user/user-remove.js +43 -45
  412. package/dist/m365/spo/commands/userprofile/userprofile-get.js +22 -22
  413. package/dist/m365/spo/commands/userprofile/userprofile-set.js +41 -33
  414. package/dist/m365/spo/commands/web/web-add.js +71 -97
  415. package/dist/m365/spo/commands/web/web-clientsidewebpart-list.js +29 -26
  416. package/dist/m365/spo/commands/web/web-get.js +21 -18
  417. package/dist/m365/spo/commands/web/web-installedlanguage-list.js +20 -17
  418. package/dist/m365/spo/commands/web/web-list.js +24 -21
  419. package/dist/m365/spo/commands/web/web-reindex.js +40 -52
  420. package/dist/m365/spo/commands/web/web-remove.js +33 -32
  421. package/dist/m365/spo/commands/web/web-roleassignment-add.js +186 -0
  422. package/dist/m365/spo/commands/web/web-roleassignment-remove.js +168 -0
  423. package/dist/m365/spo/commands/web/web-roleinheritance-reset.js +21 -16
  424. package/dist/m365/spo/commands/web/web-set.js +51 -46
  425. package/dist/m365/spo/commands.js +4 -0
  426. package/dist/m365/teams/commands/app/app-install.js +31 -35
  427. package/dist/m365/teams/commands/app/app-list.js +16 -13
  428. package/dist/m365/teams/commands/app/app-publish.js +23 -20
  429. package/dist/m365/teams/commands/app/app-remove.js +29 -28
  430. package/dist/m365/teams/commands/app/app-uninstall.js +28 -27
  431. package/dist/m365/teams/commands/app/app-update.js +25 -25
  432. package/dist/m365/teams/commands/cache/cache-remove.js +24 -23
  433. package/dist/m365/teams/commands/channel/channel-add.js +15 -15
  434. package/dist/m365/teams/commands/channel/channel-get.js +28 -48
  435. package/dist/m365/teams/commands/channel/channel-list.js +18 -20
  436. package/dist/m365/teams/commands/channel/channel-member-add.js +18 -23
  437. package/dist/m365/teams/commands/channel/channel-member-list.js +25 -36
  438. package/dist/m365/teams/commands/channel/channel-member-remove.js +26 -25
  439. package/dist/m365/teams/commands/channel/channel-member-set.js +29 -51
  440. package/dist/m365/teams/commands/channel/channel-remove.js +58 -64
  441. package/dist/m365/teams/commands/channel/channel-set.js +27 -24
  442. package/dist/m365/teams/commands/chat/chat-get.js +15 -25
  443. package/dist/m365/teams/commands/chat/chat-list.js +12 -9
  444. package/dist/m365/teams/commands/chat/chat-member-list.js +11 -8
  445. package/dist/m365/teams/commands/chat/chat-message-list.js +27 -24
  446. package/dist/m365/teams/commands/chat/chat-message-send.js +14 -24
  447. package/dist/m365/teams/commands/funsettings/funsettings-list.js +17 -14
  448. package/dist/m365/teams/commands/funsettings/funsettings-set.js +26 -21
  449. package/dist/m365/teams/commands/guestsettings/guestsettings-list.js +17 -14
  450. package/dist/m365/teams/commands/guestsettings/guestsettings-set.js +23 -18
  451. package/dist/m365/teams/commands/membersettings/membersettings-list.js +17 -14
  452. package/dist/m365/teams/commands/membersettings/membersettings-set.js +23 -18
  453. package/dist/m365/teams/commands/message/message-get.js +17 -14
  454. package/dist/m365/teams/commands/message/message-list.js +16 -13
  455. package/dist/m365/teams/commands/message/message-reply-list.js +15 -12
  456. package/dist/m365/teams/commands/messagingsettings/messagingsettings-list.js +17 -14
  457. package/dist/m365/teams/commands/messagingsettings/messagingsettings-set.js +23 -18
  458. package/dist/m365/teams/commands/report/report-directroutingcalls.js +18 -15
  459. package/dist/m365/teams/commands/report/report-pstncalls.js +18 -15
  460. package/dist/m365/teams/commands/tab/tab-add.js +20 -17
  461. package/dist/m365/teams/commands/tab/tab-get.js +25 -45
  462. package/dist/m365/teams/commands/tab/tab-list.js +14 -11
  463. package/dist/m365/teams/commands/tab/tab-remove.js +29 -26
  464. package/dist/m365/teams/commands/team/team-add.js +53 -55
  465. package/dist/m365/teams/commands/team/team-archive.js +26 -23
  466. package/dist/m365/teams/commands/team/team-clone.js +40 -35
  467. package/dist/m365/teams/commands/team/team-get.js +22 -24
  468. package/dist/m365/teams/commands/team/team-list.js +28 -18
  469. package/dist/m365/teams/commands/team/team-remove.js +34 -35
  470. package/dist/m365/teams/commands/team/team-set.js +26 -21
  471. package/dist/m365/teams/commands/team/team-unarchive.js +23 -20
  472. package/dist/m365/teams/commands/user/user-app-add.js +20 -15
  473. package/dist/m365/teams/commands/user/user-app-list.js +31 -35
  474. package/dist/m365/teams/commands/user/user-app-remove.js +30 -29
  475. package/dist/m365/teams/commands/user/user-list.js +16 -18
  476. package/dist/m365/tenant/commands/id/id-get.js +36 -25
  477. package/dist/m365/tenant/commands/report/report-office365activationcounts.js +37 -23
  478. package/dist/m365/tenant/commands/report/report-office365activationsusercounts.js +37 -23
  479. package/dist/m365/tenant/commands/report/report-office365activationsuserdetail.js +37 -23
  480. package/dist/m365/tenant/commands/security/security-alerts-list.js +19 -7
  481. package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-health-get.js +19 -7
  482. package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-health-list.js +19 -7
  483. package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-healthissue-get.js +26 -14
  484. package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-healthissue-list.js +23 -11
  485. package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-message-get.js +20 -17
  486. package/dist/m365/tenant/commands/serviceannouncement/serviceannouncement-message-list.js +23 -11
  487. package/dist/m365/todo/commands/list/list-add.js +31 -19
  488. package/dist/m365/todo/commands/list/list-list.js +19 -7
  489. package/dist/m365/todo/commands/list/list-remove.js +51 -60
  490. package/dist/m365/todo/commands/list/list-set.js +29 -34
  491. package/dist/m365/todo/commands/task/task-add.js +27 -34
  492. package/dist/m365/todo/commands/task/task-list.js +27 -34
  493. package/dist/m365/todo/commands/task/task-remove.js +51 -60
  494. package/dist/m365/todo/commands/task/task-set.js +26 -28
  495. package/dist/m365/util/commands/accesstoken/accesstoken-get.js +26 -14
  496. package/dist/m365/viva/commands/connections/connections-app-create.js +102 -104
  497. package/dist/m365/yammer/commands/group/group-list.js +11 -8
  498. package/dist/m365/yammer/commands/group/group-user-add.js +21 -16
  499. package/dist/m365/yammer/commands/group/group-user-remove.js +38 -37
  500. package/dist/m365/yammer/commands/message/message-add.js +27 -24
  501. package/dist/m365/yammer/commands/message/message-get.js +18 -15
  502. package/dist/m365/yammer/commands/message/message-like-set.js +44 -45
  503. package/dist/m365/yammer/commands/message/message-list.js +24 -21
  504. package/dist/m365/yammer/commands/message/message-remove.js +30 -29
  505. package/dist/m365/yammer/commands/network/network-list.js +29 -17
  506. package/dist/m365/yammer/commands/user/user-get.js +25 -22
  507. package/dist/m365/yammer/commands/user/user-list.js +11 -8
  508. package/dist/m365/yammer/commands/yammer-search.js +76 -73
  509. package/dist/request.js +6 -2
  510. package/dist/utils/fsUtil.js +2 -4
  511. package/dist/utils/md.js +1 -1
  512. package/docs/docs/cmd/adaptivecard/adaptivecard-send.md +0 -20
  513. package/docs/docs/cmd/graph/changelog/changelog-list.md +53 -0
  514. package/docs/docs/cmd/onenote/notebook/notebook-list.md +70 -0
  515. package/docs/docs/cmd/outlook/mail/mail-send.md +44 -1
  516. package/docs/docs/cmd/pp/environment/environment-list.md +1 -1
  517. package/docs/docs/cmd/request.md +76 -0
  518. package/docs/docs/cmd/spfx/project/project-upgrade.md +1 -1
  519. package/docs/docs/cmd/spfx/spfx-doctor.md +3 -3
  520. package/docs/docs/cmd/spo/hubsite/hubsite-unregister.md +2 -2
  521. package/docs/docs/cmd/spo/list/list-roleassignment-add.md +2 -2
  522. package/docs/docs/cmd/spo/list/list-roleassignment-remove.md +5 -2
  523. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.md +67 -0
  524. package/docs/docs/cmd/spo/listitem/listitem-roleinheritance-break.md +6 -6
  525. package/docs/docs/cmd/spo/roledefinition/roledefinition-add.md +43 -0
  526. package/docs/docs/cmd/spo/web/web-roleassignment-add.md +57 -0
  527. package/docs/docs/cmd/spo/web/web-roleassignment-remove.md +54 -0
  528. package/npm-shrinkwrap.json +2 -2
  529. package/package.json +3 -2
  530. package/scripts/Register-CLIM365Completion.ps1 +1 -1
@@ -37,119 +37,126 @@ class SpfxPackageGenerateCommand extends AnonymousCommand_1.default {
37
37
  get description() {
38
38
  return 'Generates SharePoint Framework solution package with a no-framework web part rendering the specified HTML snippet';
39
39
  }
40
- commandAction(logger, args, cb) {
41
- const supportedHosts = ['SharePointWebPart'];
42
- if (args.options.enableForTeams === 'tab' || args.options.enableForTeams === 'all') {
43
- supportedHosts.push('TeamsTab');
44
- }
45
- if (args.options.enableForTeams === 'personalApp' || args.options.enableForTeams === 'all') {
46
- supportedHosts.push('TeamsPersonalApp');
47
- }
48
- const tokens = {
49
- clientSideAssetsFeatureId: SpfxPackageGenerateCommand.generateNewId(),
50
- developerName: args.options.developerName || 'Contoso',
51
- developerWebsiteUrl: args.options.developerWebsiteUrl || 'https://contoso.com/my-app',
52
- developerPrivacyUrl: args.options.developerPrivacyUrl || 'https://contoso.com/privacy',
53
- developerTermsOfUseUrl: args.options.developerTermsOfUseUrl || 'https://contoso.com/terms-of-use',
54
- developerMpnId: args.options.developerMpnId || '000000',
55
- exposePageContextGlobally: args.options.exposePageContextGlobally ? '!0' : '!1',
56
- exposeTeamsContextGlobally: args.options.exposeTeamsContextGlobally ? '!0' : '!1',
57
- html: args.options.html.replace(/"/g, '\\"').replace(/\r\n/g, ' ').replace(/\n/g, ' '),
58
- packageName: SpfxPackageGenerateCommand.getSafePackageName(args.options.webPartTitle),
59
- productId: SpfxPackageGenerateCommand.generateNewId(),
60
- skipFeatureDeployment: (args.options.allowTenantWideDeployment === true).toString(),
61
- supportedHosts: JSON.stringify(supportedHosts).replace(/"/g, '"'),
62
- webPartId: SpfxPackageGenerateCommand.generateNewId(),
63
- webPartFeatureName: `${args.options.webPartTitle} Feature`,
64
- webPartFeatureDescription: `A feature which activates the Client-Side WebPart named ${args.options.webPartTitle}`,
65
- webPartAlias: SpfxPackageGenerateCommand.getWebPartAlias(args.options.webPartTitle),
66
- webPartName: args.options.webPartTitle,
67
- webPartSafeName: SpfxPackageGenerateCommand.getSafeWebPartName(args.options.webPartTitle),
68
- webPartDescription: args.options.webPartDescription,
69
- webPartModule: SpfxPackageGenerateCommand.getSafePackageName(args.options.webPartTitle)
70
- };
71
- let tmpDir = undefined;
72
- let error;
73
- try {
74
- if (this.verbose) {
75
- logger.log(`Creating temp folder...`);
76
- }
77
- tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cli-spfx'));
78
- if (this.debug) {
79
- logger.log(`Temp folder created at ${tmpDir}`);
40
+ commandAction(logger, args) {
41
+ return __awaiter(this, void 0, void 0, function* () {
42
+ const supportedHosts = ['SharePointWebPart'];
43
+ if (args.options.enableForTeams === 'tab' || args.options.enableForTeams === 'all') {
44
+ supportedHosts.push('TeamsTab');
80
45
  }
81
- if (this.verbose) {
82
- logger.log('Copying files...');
46
+ if (args.options.enableForTeams === 'personalApp' || args.options.enableForTeams === 'all') {
47
+ supportedHosts.push('TeamsPersonalApp');
83
48
  }
84
- const src = path.join(__dirname, 'package-generate', 'assets');
85
- utils_1.fsUtil.copyRecursiveSync(src, tmpDir, s => SpfxPackageGenerateCommand.replaceTokens(s, tokens));
86
- const files = utils_1.fsUtil.readdirR(tmpDir);
87
- if (this.verbose) {
88
- logger.log('Processing files...');
89
- }
90
- files.forEach(filePath => {
49
+ const tokens = {
50
+ clientSideAssetsFeatureId: SpfxPackageGenerateCommand.generateNewId(),
51
+ developerName: args.options.developerName || 'Contoso',
52
+ developerWebsiteUrl: args.options.developerWebsiteUrl || 'https://contoso.com/my-app',
53
+ developerPrivacyUrl: args.options.developerPrivacyUrl || 'https://contoso.com/privacy',
54
+ developerTermsOfUseUrl: args.options.developerTermsOfUseUrl || 'https://contoso.com/terms-of-use',
55
+ developerMpnId: args.options.developerMpnId || '000000',
56
+ exposePageContextGlobally: args.options.exposePageContextGlobally ? '!0' : '!1',
57
+ exposeTeamsContextGlobally: args.options.exposeTeamsContextGlobally ? '!0' : '!1',
58
+ html: args.options.html.replace(/"/g, '\\"').replace(/\r\n/g, ' ').replace(/\n/g, ' '),
59
+ packageName: SpfxPackageGenerateCommand.getSafePackageName(args.options.webPartTitle),
60
+ productId: SpfxPackageGenerateCommand.generateNewId(),
61
+ skipFeatureDeployment: (args.options.allowTenantWideDeployment === true).toString(),
62
+ supportedHosts: JSON.stringify(supportedHosts).replace(/"/g, '"'),
63
+ webPartId: SpfxPackageGenerateCommand.generateNewId(),
64
+ webPartFeatureName: `${args.options.webPartTitle} Feature`,
65
+ webPartFeatureDescription: `A feature which activates the Client-Side WebPart named ${args.options.webPartTitle}`,
66
+ webPartAlias: SpfxPackageGenerateCommand.getWebPartAlias(args.options.webPartTitle),
67
+ webPartName: args.options.webPartTitle,
68
+ webPartSafeName: SpfxPackageGenerateCommand.getSafeWebPartName(args.options.webPartTitle),
69
+ webPartDescription: args.options.webPartDescription,
70
+ webPartModule: SpfxPackageGenerateCommand.getSafePackageName(args.options.webPartTitle)
71
+ };
72
+ let tmpDir = undefined;
73
+ let error;
74
+ try {
75
+ if (this.verbose) {
76
+ logger.log(`Creating temp folder...`);
77
+ }
78
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cli-spfx'));
91
79
  if (this.debug) {
92
- logger.log(`Processing ${filePath}...`);
80
+ logger.log(`Temp folder created at ${tmpDir}`);
93
81
  }
94
- if (!SpfxPackageGenerateCommand.isBinaryFile(filePath)) {
95
- if (this.verbose) {
96
- logger.log('Replacing tokens...');
97
- }
98
- let fileContents = fs.readFileSync(filePath, 'utf-8');
82
+ if (this.verbose) {
83
+ logger.log('Copying files...');
84
+ }
85
+ const src = path.join(__dirname, 'package-generate', 'assets');
86
+ utils_1.fsUtil.copyRecursiveSync(src, tmpDir, s => SpfxPackageGenerateCommand.replaceTokens(s, tokens));
87
+ const files = utils_1.fsUtil.readdirR(tmpDir);
88
+ if (this.verbose) {
89
+ logger.log('Processing files...');
90
+ }
91
+ files.forEach(filePath => {
99
92
  if (this.debug) {
100
- logger.log('Before:');
101
- logger.log(fileContents);
93
+ logger.log(`Processing ${filePath}...`);
102
94
  }
103
- fileContents = SpfxPackageGenerateCommand.replaceTokens(fileContents, tokens);
104
- if (this.debug) {
105
- logger.log('After:');
106
- logger.log(fileContents);
95
+ if (!SpfxPackageGenerateCommand.isBinaryFile(filePath)) {
96
+ if (this.verbose) {
97
+ logger.log('Replacing tokens...');
98
+ }
99
+ let fileContents = fs.readFileSync(filePath, 'utf-8');
100
+ if (this.debug) {
101
+ logger.log('Before:');
102
+ logger.log(fileContents);
103
+ }
104
+ fileContents = SpfxPackageGenerateCommand.replaceTokens(fileContents, tokens);
105
+ if (this.debug) {
106
+ logger.log('After:');
107
+ logger.log(fileContents);
108
+ }
109
+ fs.writeFileSync(filePath, fileContents, { encoding: 'utf-8' });
110
+ }
111
+ else {
112
+ if (this.verbose) {
113
+ logger.log(`Binary file. Skipping replacing tokens in contents`);
114
+ }
107
115
  }
108
- fs.writeFileSync(filePath, fileContents, { encoding: 'utf-8' });
116
+ });
117
+ if (this.verbose) {
118
+ logger.log('Creating .sppkg file...');
119
+ }
120
+ // we need this to be able to inject mock AdmZip for testing
121
+ /* c8 ignore next 3 */
122
+ if (!this.archive) {
123
+ this.archive = new AdmZip();
109
124
  }
110
- else {
111
- if (this.verbose) {
112
- logger.log(`Binary file. Skipping replacing tokens in contents`);
125
+ const filesToZip = utils_1.fsUtil.readdirR(tmpDir);
126
+ filesToZip.forEach(f => {
127
+ if (this.debug) {
128
+ logger.log(`Adding ${f} to archive...`);
113
129
  }
130
+ this.archive.addLocalFile(f, path.relative(tmpDir, path.dirname(f)), path.basename(f));
131
+ });
132
+ if (this.debug) {
133
+ logger.log('Writing archive...');
114
134
  }
115
- });
116
- if (this.verbose) {
117
- logger.log('Creating .sppkg file...');
135
+ this.archive.writeZip(`${args.options.packageName}.sppkg`);
118
136
  }
119
- // we need this to be able to inject mock AdmZip for testing
120
- /* c8 ignore next 3 */
121
- if (!this.archive) {
122
- this.archive = new AdmZip();
137
+ catch (err) {
138
+ error = err.message;
123
139
  }
124
- const filesToZip = utils_1.fsUtil.readdirR(tmpDir);
125
- filesToZip.forEach(f => {
126
- if (this.debug) {
127
- logger.log(`Adding ${f} to archive...`);
140
+ finally {
141
+ try {
142
+ if (tmpDir) {
143
+ if (this.verbose) {
144
+ logger.log(`Deleting temp folder at ${tmpDir}...`);
145
+ }
146
+ fs.rmdirSync(tmpDir, { recursive: true });
147
+ }
148
+ if (error) {
149
+ throw error;
150
+ }
128
151
  }
129
- this.archive.addLocalFile(f, path.relative(tmpDir, path.dirname(f)), path.basename(f));
130
- });
131
- if (this.debug) {
132
- logger.log('Writing archive...');
133
- }
134
- this.archive.writeZip(`${args.options.packageName}.sppkg`);
135
- }
136
- catch (err) {
137
- error = err.message;
138
- }
139
- finally {
140
- try {
141
- if (tmpDir) {
142
- if (this.verbose) {
143
- logger.log(`Deleting temp folder at ${tmpDir}...`);
152
+ catch (ex) {
153
+ if (ex === error) {
154
+ throw ex;
144
155
  }
145
- fs.rmdirSync(tmpDir, { recursive: true });
156
+ throw `An error has occurred while removing the temp folder at ${tmpDir}. Please remove it manually.`;
146
157
  }
147
- cb(error);
148
158
  }
149
- catch (ex) {
150
- cb(`An error has occurred while removing the temp folder at ${tmpDir}. Please remove it manually.`);
151
- }
152
- }
159
+ });
153
160
  }
154
161
  static replaceTokens(s, tokens) {
155
162
  return s.replace(/\$([^\$]+)\$/g, (substring, token) => {
@@ -0,0 +1,23 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const FN001008_DEP_react_1 = require("./rules/FN001008_DEP_react");
4
+ const FN001009_DEP_react_dom_1 = require("./rules/FN001009_DEP_react_dom");
5
+ const FN001022_DEP_office_ui_fabric_react_1 = require("./rules/FN001022_DEP_office_ui_fabric_react");
6
+ const FN002004_DEVDEP_gulp_1 = require("./rules/FN002004_DEVDEP_gulp");
7
+ const FN002007_DEVDEP_ajv_1 = require("./rules/FN002007_DEVDEP_ajv");
8
+ const FN002013_DEVDEP_types_webpack_env_1 = require("./rules/FN002013_DEVDEP_types_webpack_env");
9
+ const FN002015_DEVDEP_types_react_1 = require("./rules/FN002015_DEVDEP_types_react");
10
+ const FN002016_DEVDEP_types_react_dom_1 = require("./rules/FN002016_DEVDEP_types_react_dom");
11
+ const FN002019_DEVDEP_microsoft_rush_stack_compiler_1 = require("./rules/FN002019_DEVDEP_microsoft_rush_stack_compiler");
12
+ module.exports = [
13
+ new FN001008_DEP_react_1.FN001008_DEP_react('16'),
14
+ new FN001009_DEP_react_dom_1.FN001009_DEP_react_dom('16'),
15
+ new FN001022_DEP_office_ui_fabric_react_1.FN001022_DEP_office_ui_fabric_react('7.192.0'),
16
+ new FN002004_DEVDEP_gulp_1.FN002004_DEVDEP_gulp('4.0.2'),
17
+ new FN002007_DEVDEP_ajv_1.FN002007_DEVDEP_ajv('^6.12.5'),
18
+ new FN002013_DEVDEP_types_webpack_env_1.FN002013_DEVDEP_types_webpack_env('~1.15.2'),
19
+ new FN002015_DEVDEP_types_react_1.FN002015_DEVDEP_types_react('16'),
20
+ new FN002016_DEVDEP_types_react_dom_1.FN002016_DEVDEP_types_react_dom('16'),
21
+ new FN002019_DEVDEP_microsoft_rush_stack_compiler_1.FN002019_DEVDEP_microsoft_rush_stack_compiler(['4.5'])
22
+ ];
23
+ //# sourceMappingURL=doctor-1.16.0-beta.1.js.map
@@ -61,7 +61,8 @@ class SpfxProjectDoctorCommand extends base_project_command_1.BaseProjectCommand
61
61
  '1.13.1',
62
62
  '1.14.0',
63
63
  '1.15.0',
64
- '1.15.2'
64
+ '1.15.2',
65
+ '1.16.0-beta.1'
65
66
  ];
66
67
  __classPrivateFieldGet(this, _SpfxProjectDoctorCommand_instances, "m", _SpfxProjectDoctorCommand_initTelemetry).call(this);
67
68
  __classPrivateFieldGet(this, _SpfxProjectDoctorCommand_instances, "m", _SpfxProjectDoctorCommand_initOptions).call(this);
@@ -73,113 +74,110 @@ class SpfxProjectDoctorCommand extends base_project_command_1.BaseProjectCommand
73
74
  get description() {
74
75
  return 'Validates correctness of a SharePoint Framework project';
75
76
  }
76
- commandAction(logger, args, cb) {
77
- this.projectRootPath = this.getProjectRoot(process.cwd());
78
- if (this.projectRootPath === null) {
79
- cb(new Command_1.CommandError(`Couldn't find project root folder`, SpfxProjectDoctorCommand.ERROR_NO_PROJECT_ROOT_FOLDER));
80
- return;
81
- }
82
- this.packageManager = args.options.packageManager || 'npm';
83
- if (this.verbose) {
84
- logger.logToStderr('Collecting project...');
85
- }
86
- const project = this.getProject(this.projectRootPath);
87
- if (this.debug) {
88
- logger.logToStderr('Collected project');
89
- logger.logToStderr(project);
90
- }
91
- project.version = this.getProjectVersion();
92
- if (!project.version) {
93
- cb(new Command_1.CommandError(`Unable to determine the version of the current SharePoint Framework project`, SpfxProjectDoctorCommand.ERROR_NO_VERSION));
94
- return;
95
- }
96
- if (!this.supportedVersions.includes(project.version)) {
97
- cb(new Command_1.CommandError(`CLI for Microsoft 365 doesn't support validating projects built using SharePoint Framework v${project.version}`, SpfxProjectDoctorCommand.ERROR_UNSUPPORTED_VERSION));
98
- return;
99
- }
100
- if (this.verbose) {
101
- logger.logToStderr(`Project built using SPFx v${project.version}`);
102
- }
103
- const rules = [...generic_rules_1.rules];
104
- try {
105
- const versionRules = require(`./project-doctor/doctor-${project.version}`);
106
- rules.push(...versionRules);
107
- }
108
- catch (e) {
109
- cb(new Command_1.CommandError(e.message));
110
- return;
111
- }
112
- rules.forEach(r => {
113
- r.visit(project, this.allFindings);
114
- });
115
- if (this.packageManager === 'npm') {
116
- const npmDedupeRule = new FN017001_MISC_npm_dedupe_1.FN017001_MISC_npm_dedupe();
117
- npmDedupeRule.visit(project, this.allFindings);
118
- }
119
- // remove superseded findings
120
- this.allFindings
121
- // get findings that supersede other findings
122
- .filter(f => f.supersedes.length > 0)
123
- .forEach(f => {
124
- f.supersedes.forEach(s => {
125
- // find the superseded finding
126
- const i = this.allFindings.findIndex(f1 => f1.id === s);
127
- if (i > -1) {
128
- // ...and remove it from findings
129
- this.allFindings.splice(i, 1);
130
- }
131
- });
132
- });
133
- // flatten
134
- const findingsToReport = [].concat.apply([], this.allFindings.map(f => {
135
- return f.occurrences.map(o => {
136
- return {
137
- description: f.description,
138
- id: f.id,
139
- file: o.file,
140
- position: o.position,
141
- resolution: o.resolution,
142
- resolutionType: f.resolutionType,
143
- severity: f.severity,
144
- title: f.title
145
- };
146
- });
147
- }));
148
- // replace package operation tokens with command for the specific package manager
149
- findingsToReport.forEach(f => {
150
- // matches must be in this particular order to avoid false matches, eg.
151
- // uninstallDev contains install
152
- if (f.resolution.startsWith('uninstallDev')) {
153
- f.resolution = f.resolution.replace('uninstallDev', utils_1.packageManager.getPackageManagerCommand('uninstallDev', this.packageManager));
154
- return;
77
+ commandAction(logger, args) {
78
+ return __awaiter(this, void 0, void 0, function* () {
79
+ this.projectRootPath = this.getProjectRoot(process.cwd());
80
+ if (this.projectRootPath === null) {
81
+ throw new Command_1.CommandError(`Couldn't find project root folder`, SpfxProjectDoctorCommand.ERROR_NO_PROJECT_ROOT_FOLDER);
82
+ }
83
+ this.packageManager = args.options.packageManager || 'npm';
84
+ if (this.verbose) {
85
+ logger.logToStderr('Collecting project...');
155
86
  }
156
- if (f.resolution.startsWith('installDev')) {
157
- f.resolution = f.resolution.replace('installDev', utils_1.packageManager.getPackageManagerCommand('installDev', this.packageManager));
158
- return;
87
+ const project = this.getProject(this.projectRootPath);
88
+ if (this.debug) {
89
+ logger.logToStderr('Collected project');
90
+ logger.logToStderr(project);
159
91
  }
160
- if (f.resolution.startsWith('uninstall')) {
161
- f.resolution = f.resolution.replace('uninstall', utils_1.packageManager.getPackageManagerCommand('uninstall', this.packageManager));
162
- return;
92
+ project.version = this.getProjectVersion();
93
+ if (!project.version) {
94
+ throw new Command_1.CommandError(`Unable to determine the version of the current SharePoint Framework project`, SpfxProjectDoctorCommand.ERROR_NO_VERSION);
163
95
  }
164
- if (f.resolution.startsWith('install')) {
165
- f.resolution = f.resolution.replace('install', utils_1.packageManager.getPackageManagerCommand('install', this.packageManager));
166
- return;
96
+ if (!this.supportedVersions.includes(project.version)) {
97
+ throw new Command_1.CommandError(`CLI for Microsoft 365 doesn't support validating projects built using SharePoint Framework v${project.version}`, SpfxProjectDoctorCommand.ERROR_UNSUPPORTED_VERSION);
98
+ }
99
+ if (this.verbose) {
100
+ logger.logToStderr(`Project built using SPFx v${project.version}`);
101
+ }
102
+ const rules = [...generic_rules_1.rules];
103
+ try {
104
+ const versionRules = require(`./project-doctor/doctor-${project.version}`);
105
+ rules.push(...versionRules);
106
+ }
107
+ catch (e) {
108
+ throw new Command_1.CommandError(e.message);
109
+ }
110
+ rules.forEach(r => {
111
+ r.visit(project, this.allFindings);
112
+ });
113
+ if (this.packageManager === 'npm') {
114
+ const npmDedupeRule = new FN017001_MISC_npm_dedupe_1.FN017001_MISC_npm_dedupe();
115
+ npmDedupeRule.visit(project, this.allFindings);
116
+ }
117
+ // remove superseded findings
118
+ this.allFindings
119
+ // get findings that supersede other findings
120
+ .filter(f => f.supersedes.length > 0)
121
+ .forEach(f => {
122
+ f.supersedes.forEach(s => {
123
+ // find the superseded finding
124
+ const i = this.allFindings.findIndex(f1 => f1.id === s);
125
+ if (i > -1) {
126
+ // ...and remove it from findings
127
+ this.allFindings.splice(i, 1);
128
+ }
129
+ });
130
+ });
131
+ // flatten
132
+ const findingsToReport = [].concat.apply([], this.allFindings.map(f => {
133
+ return f.occurrences.map(o => {
134
+ return {
135
+ description: f.description,
136
+ id: f.id,
137
+ file: o.file,
138
+ position: o.position,
139
+ resolution: o.resolution,
140
+ resolutionType: f.resolutionType,
141
+ severity: f.severity,
142
+ title: f.title
143
+ };
144
+ });
145
+ }));
146
+ // replace package operation tokens with command for the specific package manager
147
+ findingsToReport.forEach(f => {
148
+ // matches must be in this particular order to avoid false matches, eg.
149
+ // uninstallDev contains install
150
+ if (f.resolution.startsWith('uninstallDev')) {
151
+ f.resolution = f.resolution.replace('uninstallDev', utils_1.packageManager.getPackageManagerCommand('uninstallDev', this.packageManager));
152
+ return;
153
+ }
154
+ if (f.resolution.startsWith('installDev')) {
155
+ f.resolution = f.resolution.replace('installDev', utils_1.packageManager.getPackageManagerCommand('installDev', this.packageManager));
156
+ return;
157
+ }
158
+ if (f.resolution.startsWith('uninstall')) {
159
+ f.resolution = f.resolution.replace('uninstall', utils_1.packageManager.getPackageManagerCommand('uninstall', this.packageManager));
160
+ return;
161
+ }
162
+ if (f.resolution.startsWith('install')) {
163
+ f.resolution = f.resolution.replace('install', utils_1.packageManager.getPackageManagerCommand('install', this.packageManager));
164
+ return;
165
+ }
166
+ });
167
+ switch (args.options.output) {
168
+ case 'text':
169
+ logger.log(this.getTextReport(findingsToReport));
170
+ break;
171
+ case 'tour':
172
+ this.writeReportTourFolder(this.getTourReport(findingsToReport));
173
+ break;
174
+ case 'md':
175
+ logger.log(this.getMdReport(findingsToReport));
176
+ break;
177
+ default:
178
+ logger.log(findingsToReport);
167
179
  }
168
180
  });
169
- switch (args.options.output) {
170
- case 'text':
171
- logger.log(this.getTextReport(findingsToReport));
172
- break;
173
- case 'tour':
174
- this.writeReportTourFolder(this.getTourReport(findingsToReport));
175
- break;
176
- case 'md':
177
- logger.log(this.getMdReport(findingsToReport));
178
- break;
179
- default:
180
- logger.log(findingsToReport);
181
- }
182
- cb();
183
181
  }
184
182
  writeReportTourFolder(findingsToReport) {
185
183
  const toursFolder = path.join(this.projectRootPath, '.tours');
@@ -1,4 +1,13 @@
1
1
  "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
2
11
  var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
3
12
  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
4
13
  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");
@@ -50,44 +59,42 @@ class SpfxProjectExternalizeCommand extends base_project_command_1.BaseProjectCo
50
59
  get description() {
51
60
  return 'Externalizes SharePoint Framework project dependencies';
52
61
  }
53
- commandAction(logger, args, cb) {
54
- if (args.options.output !== 'json' || this.verbose) {
55
- logger.logToStderr(`This command is currently in preview. Feedback welcome at https://github.com/pnp/cli-microsoft365/issues${os.EOL}`);
56
- }
57
- this.projectRootPath = this.getProjectRoot(process.cwd());
58
- if (this.projectRootPath === null) {
59
- cb(new Command_1.CommandError(`Couldn't find project root folder`, SpfxProjectExternalizeCommand.ERROR_NO_PROJECT_ROOT_FOLDER));
60
- return;
61
- }
62
- this.projectVersion = this.getProjectVersion();
63
- if (!this.projectVersion) {
64
- cb(new Command_1.CommandError(`Unable to determine the version of the current SharePoint Framework project`, SpfxProjectExternalizeCommand.ERROR_NO_VERSION));
65
- return;
66
- }
67
- if (this.projectVersion && this.supportedVersions.indexOf(this.projectVersion) < 0) {
68
- cb(new Command_1.CommandError(`CLI for Microsoft 365 doesn't support externalizing dependencies of SharePoint Framework projects of version ${this.projectVersion}. Supported versions are ${this.supportedVersions.join(', ')}`, SpfxProjectExternalizeCommand.ERROR_UNSUPPORTED_VERSION));
69
- return;
70
- }
71
- if (this.verbose) {
72
- logger.logToStderr('Collecting project...');
73
- }
74
- const project = this.getProject(this.projectRootPath);
75
- if (this.debug) {
76
- logger.logToStderr('Collected project');
77
- logger.logToStderr(project);
78
- }
79
- const asyncRulesResults = rules.map(r => r.visit(project));
80
- Promise
81
- .all(asyncRulesResults)
82
- .then((rulesResults) => {
83
- this.allFindings.push(...rulesResults.map(x => x.entries).reduce((x, y) => [...x, ...y]));
84
- this.allEditSuggestions.push(...rulesResults.map(x => x.suggestions).reduce((x, y) => [...x, ...y]));
85
- //removing duplicates
86
- this.allFindings = this.allFindings.filter((x, i) => this.allFindings.findIndex(y => y.key === x.key) === i);
87
- this.writeReport(this.allFindings, this.allEditSuggestions, logger, args.options);
88
- cb();
89
- }).catch((err) => {
90
- cb(new Command_1.CommandError(err));
62
+ commandAction(logger, args) {
63
+ return __awaiter(this, void 0, void 0, function* () {
64
+ if (args.options.output !== 'json' || this.verbose) {
65
+ logger.logToStderr(`This command is currently in preview. Feedback welcome at https://github.com/pnp/cli-microsoft365/issues${os.EOL}`);
66
+ }
67
+ this.projectRootPath = this.getProjectRoot(process.cwd());
68
+ if (this.projectRootPath === null) {
69
+ throw new Command_1.CommandError(`Couldn't find project root folder`, SpfxProjectExternalizeCommand.ERROR_NO_PROJECT_ROOT_FOLDER);
70
+ }
71
+ this.projectVersion = this.getProjectVersion();
72
+ if (!this.projectVersion) {
73
+ throw new Command_1.CommandError(`Unable to determine the version of the current SharePoint Framework project`, SpfxProjectExternalizeCommand.ERROR_NO_VERSION);
74
+ }
75
+ if (this.projectVersion && this.supportedVersions.indexOf(this.projectVersion) < 0) {
76
+ throw new Command_1.CommandError(`CLI for Microsoft 365 doesn't support externalizing dependencies of SharePoint Framework projects of version ${this.projectVersion}. Supported versions are ${this.supportedVersions.join(', ')}`, SpfxProjectExternalizeCommand.ERROR_UNSUPPORTED_VERSION);
77
+ }
78
+ if (this.verbose) {
79
+ logger.logToStderr('Collecting project...');
80
+ }
81
+ const project = this.getProject(this.projectRootPath);
82
+ if (this.debug) {
83
+ logger.logToStderr('Collected project');
84
+ logger.logToStderr(project);
85
+ }
86
+ const asyncRulesResults = rules.map(r => r.visit(project));
87
+ try {
88
+ const rulesResults = yield Promise.all(asyncRulesResults);
89
+ this.allFindings.push(...rulesResults.map(x => x.entries).reduce((x, y) => [...x, ...y]));
90
+ this.allEditSuggestions.push(...rulesResults.map(x => x.suggestions).reduce((x, y) => [...x, ...y]));
91
+ //removing duplicates
92
+ this.allFindings = this.allFindings.filter((x, i) => this.allFindings.findIndex(y => y.key === x.key) === i);
93
+ this.writeReport(this.allFindings, this.allEditSuggestions, logger, args.options);
94
+ }
95
+ catch (err) {
96
+ throw new Command_1.CommandError(err);
97
+ }
91
98
  });
92
99
  }
93
100
  writeReport(findingsToReport, editsToReport, logger, options) {