@strapi/upgrade 0.0.0-experimental.62ce06180fe9a772eaeb3d43d238b26644f39f7c → 0.0.0-experimental.6340da17068c3bed7fb006e7bcc554c71129e282

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 (303) hide show
  1. package/LICENSE +19 -4
  2. package/README.md +28 -11
  3. package/dist/cli.js +18 -1451
  4. package/dist/cli.js.map +1 -1
  5. package/dist/cli.mjs +14 -0
  6. package/dist/cli.mjs.map +1 -0
  7. package/dist/index.js +8 -1427
  8. package/dist/index.js.map +1 -1
  9. package/dist/index.mjs +4 -1420
  10. package/dist/index.mjs.map +1 -1
  11. package/dist/modules/codemod/codemod.d.ts.map +1 -1
  12. package/dist/modules/codemod-repository/constants.d.ts.map +1 -1
  13. package/dist/modules/codemod-repository/repository.d.ts.map +1 -1
  14. package/dist/modules/codemod-runner/codemod-runner.d.ts.map +1 -1
  15. package/dist/modules/error/utils.d.ts +8 -0
  16. package/dist/modules/error/utils.d.ts.map +1 -1
  17. package/dist/modules/file-scanner/scanner.d.ts.map +1 -1
  18. package/dist/modules/format/formats.d.ts +2 -1
  19. package/dist/modules/format/formats.d.ts.map +1 -1
  20. package/dist/modules/json/file.d.ts.map +1 -1
  21. package/dist/modules/json/transform-api.d.ts.map +1 -1
  22. package/dist/modules/logger/logger.d.ts +0 -1
  23. package/dist/modules/logger/logger.d.ts.map +1 -1
  24. package/dist/modules/logger/types.d.ts +0 -1
  25. package/dist/modules/logger/types.d.ts.map +1 -1
  26. package/dist/modules/npm/package.d.ts +9 -3
  27. package/dist/modules/npm/package.d.ts.map +1 -1
  28. package/dist/modules/project/constants.d.ts +6 -5
  29. package/dist/modules/project/constants.d.ts.map +1 -1
  30. package/dist/modules/project/project.d.ts +16 -2
  31. package/dist/modules/project/project.d.ts.map +1 -1
  32. package/dist/modules/project/types.d.ts +3 -0
  33. package/dist/modules/project/types.d.ts.map +1 -1
  34. package/dist/modules/project/utils.d.ts.map +1 -1
  35. package/dist/modules/report/report.d.ts.map +1 -1
  36. package/dist/modules/requirement/requirement.d.ts.map +1 -1
  37. package/dist/modules/runner/code/code.d.ts.map +1 -1
  38. package/dist/modules/runner/json/json.d.ts.map +1 -1
  39. package/dist/modules/runner/json/transform.d.ts.map +1 -1
  40. package/dist/modules/upgrader/types.d.ts +6 -0
  41. package/dist/modules/upgrader/types.d.ts.map +1 -1
  42. package/dist/modules/upgrader/upgrader.d.ts +10 -0
  43. package/dist/modules/upgrader/upgrader.d.ts.map +1 -1
  44. package/dist/modules/version/range.d.ts.map +1 -1
  45. package/dist/modules/version/semver.d.ts +1 -1
  46. package/dist/modules/version/semver.d.ts.map +1 -1
  47. package/dist/modules/version/types.d.ts +7 -5
  48. package/dist/modules/version/types.d.ts.map +1 -1
  49. package/dist/package.json.js +6 -0
  50. package/dist/package.json.js.map +1 -0
  51. package/dist/package.json.mjs +4 -0
  52. package/dist/package.json.mjs.map +1 -0
  53. package/dist/src/cli/commands/codemods.js +116 -0
  54. package/dist/src/cli/commands/codemods.js.map +1 -0
  55. package/dist/src/cli/commands/codemods.mjs +108 -0
  56. package/dist/src/cli/commands/codemods.mjs.map +1 -0
  57. package/dist/src/cli/commands/upgrade.js +102 -0
  58. package/dist/src/cli/commands/upgrade.js.map +1 -0
  59. package/dist/src/cli/commands/upgrade.mjs +95 -0
  60. package/dist/src/cli/commands/upgrade.mjs.map +1 -0
  61. package/dist/src/cli/errors.js +22 -0
  62. package/dist/src/cli/errors.js.map +1 -0
  63. package/dist/src/cli/errors.mjs +16 -0
  64. package/dist/src/cli/errors.mjs.map +1 -0
  65. package/dist/src/cli/options.js +25 -0
  66. package/dist/src/cli/options.js.map +1 -0
  67. package/dist/src/cli/options.mjs +18 -0
  68. package/dist/src/cli/options.mjs.map +1 -0
  69. package/dist/src/modules/codemod/codemod.js +48 -0
  70. package/dist/src/modules/codemod/codemod.js.map +1 -0
  71. package/dist/src/modules/codemod/codemod.mjs +41 -0
  72. package/dist/src/modules/codemod/codemod.mjs.map +1 -0
  73. package/dist/src/modules/codemod/constants.js +17 -0
  74. package/dist/src/modules/codemod/constants.js.map +1 -0
  75. package/dist/src/modules/codemod/constants.mjs +11 -0
  76. package/dist/src/modules/codemod/constants.mjs.map +1 -0
  77. package/dist/src/modules/codemod/index.js +10 -0
  78. package/dist/src/modules/codemod/index.js.map +1 -0
  79. package/dist/src/modules/codemod/index.mjs +4 -0
  80. package/dist/src/modules/codemod/index.mjs.map +1 -0
  81. package/dist/src/modules/codemod-repository/constants.js +13 -0
  82. package/dist/src/modules/codemod-repository/constants.js.map +1 -0
  83. package/dist/src/modules/codemod-repository/constants.mjs +7 -0
  84. package/dist/src/modules/codemod-repository/constants.mjs.map +1 -0
  85. package/dist/src/modules/codemod-repository/index.js +10 -0
  86. package/dist/src/modules/codemod-repository/index.js.map +1 -0
  87. package/dist/src/modules/codemod-repository/index.mjs +4 -0
  88. package/dist/src/modules/codemod-repository/index.mjs.map +1 -0
  89. package/dist/src/modules/codemod-repository/repository.js +133 -0
  90. package/dist/src/modules/codemod-repository/repository.js.map +1 -0
  91. package/dist/src/modules/codemod-repository/repository.mjs +122 -0
  92. package/dist/src/modules/codemod-repository/repository.mjs.map +1 -0
  93. package/dist/src/modules/codemod-runner/codemod-runner.js +112 -0
  94. package/dist/src/modules/codemod-runner/codemod-runner.js.map +1 -0
  95. package/dist/src/modules/codemod-runner/codemod-runner.mjs +109 -0
  96. package/dist/src/modules/codemod-runner/codemod-runner.mjs.map +1 -0
  97. package/dist/src/modules/error/index.js +11 -0
  98. package/dist/src/modules/error/index.js.map +1 -0
  99. package/dist/src/modules/error/index.mjs +2 -0
  100. package/dist/src/modules/error/index.mjs.map +1 -0
  101. package/dist/src/modules/error/utils.js +33 -0
  102. package/dist/src/modules/error/utils.js.map +1 -0
  103. package/dist/src/modules/error/utils.mjs +28 -0
  104. package/dist/src/modules/error/utils.mjs.map +1 -0
  105. package/dist/src/modules/file-scanner/index.js +8 -0
  106. package/dist/src/modules/file-scanner/index.js.map +1 -0
  107. package/dist/src/modules/file-scanner/index.mjs +2 -0
  108. package/dist/src/modules/file-scanner/index.mjs.map +1 -0
  109. package/dist/src/modules/file-scanner/scanner.js +28 -0
  110. package/dist/src/modules/file-scanner/scanner.js.map +1 -0
  111. package/dist/src/modules/file-scanner/scanner.mjs +20 -0
  112. package/dist/src/modules/file-scanner/scanner.mjs.map +1 -0
  113. package/dist/src/modules/format/formats.js +112 -0
  114. package/dist/src/modules/format/formats.js.map +1 -0
  115. package/dist/src/modules/format/formats.mjs +94 -0
  116. package/dist/src/modules/format/formats.mjs.map +1 -0
  117. package/dist/src/modules/format/index.js +19 -0
  118. package/dist/src/modules/format/index.js.map +1 -0
  119. package/dist/src/modules/format/index.mjs +2 -0
  120. package/dist/src/modules/format/index.mjs.map +1 -0
  121. package/dist/src/modules/index.js +32 -0
  122. package/dist/src/modules/index.js.map +1 -0
  123. package/dist/src/modules/index.mjs +27 -0
  124. package/dist/src/modules/index.mjs.map +1 -0
  125. package/dist/src/modules/json/file.js +20 -0
  126. package/dist/src/modules/json/file.js.map +1 -0
  127. package/dist/src/modules/json/file.mjs +13 -0
  128. package/dist/src/modules/json/file.mjs.map +1 -0
  129. package/dist/src/modules/json/transform-api.js +38 -0
  130. package/dist/src/modules/json/transform-api.js.map +1 -0
  131. package/dist/src/modules/json/transform-api.mjs +35 -0
  132. package/dist/src/modules/json/transform-api.mjs.map +1 -0
  133. package/dist/src/modules/logger/index.js +8 -0
  134. package/dist/src/modules/logger/index.js.map +1 -0
  135. package/dist/src/modules/logger/index.mjs +2 -0
  136. package/dist/src/modules/logger/index.mjs.map +1 -0
  137. package/dist/src/modules/logger/logger.js +80 -0
  138. package/dist/src/modules/logger/logger.js.map +1 -0
  139. package/dist/src/modules/logger/logger.mjs +73 -0
  140. package/dist/src/modules/logger/logger.mjs.map +1 -0
  141. package/dist/src/modules/npm/constants.js +6 -0
  142. package/dist/src/modules/npm/constants.js.map +1 -0
  143. package/dist/src/modules/npm/constants.mjs +4 -0
  144. package/dist/src/modules/npm/constants.mjs.map +1 -0
  145. package/dist/src/modules/npm/package.js +143 -0
  146. package/dist/src/modules/npm/package.js.map +1 -0
  147. package/dist/src/modules/npm/package.mjs +134 -0
  148. package/dist/src/modules/npm/package.mjs.map +1 -0
  149. package/dist/src/modules/project/constants.js +45 -0
  150. package/dist/src/modules/project/constants.js.map +1 -0
  151. package/dist/src/modules/project/constants.mjs +35 -0
  152. package/dist/src/modules/project/constants.mjs.map +1 -0
  153. package/dist/src/modules/project/index.js +15 -0
  154. package/dist/src/modules/project/index.js.map +1 -0
  155. package/dist/src/modules/project/index.mjs +5 -0
  156. package/dist/src/modules/project/index.mjs.map +1 -0
  157. package/dist/src/modules/project/project.js +212 -0
  158. package/dist/src/modules/project/project.js.map +1 -0
  159. package/dist/src/modules/project/project.mjs +200 -0
  160. package/dist/src/modules/project/project.mjs.map +1 -0
  161. package/dist/src/modules/project/utils.js +26 -0
  162. package/dist/src/modules/project/utils.js.map +1 -0
  163. package/dist/src/modules/project/utils.mjs +21 -0
  164. package/dist/src/modules/project/utils.mjs.map +1 -0
  165. package/dist/src/modules/report/index.js +9 -0
  166. package/dist/src/modules/report/index.js.map +1 -0
  167. package/dist/src/modules/report/index.mjs +2 -0
  168. package/dist/src/modules/report/index.mjs.map +1 -0
  169. package/dist/src/modules/report/report.js +13 -0
  170. package/dist/src/modules/report/report.js.map +1 -0
  171. package/dist/src/modules/report/report.mjs +10 -0
  172. package/dist/src/modules/report/report.mjs.map +1 -0
  173. package/dist/src/modules/requirement/index.js +8 -0
  174. package/dist/src/modules/requirement/index.js.map +1 -0
  175. package/dist/src/modules/requirement/index.mjs +2 -0
  176. package/dist/src/modules/requirement/index.mjs.map +1 -0
  177. package/dist/src/modules/requirement/requirement.js +55 -0
  178. package/dist/src/modules/requirement/requirement.js.map +1 -0
  179. package/dist/src/modules/requirement/requirement.mjs +52 -0
  180. package/dist/src/modules/requirement/requirement.mjs.map +1 -0
  181. package/dist/src/modules/runner/code/code.js +20 -0
  182. package/dist/src/modules/runner/code/code.js.map +1 -0
  183. package/dist/src/modules/runner/code/code.mjs +17 -0
  184. package/dist/src/modules/runner/code/code.mjs.map +1 -0
  185. package/dist/src/modules/runner/code/index.js +8 -0
  186. package/dist/src/modules/runner/code/index.js.map +1 -0
  187. package/dist/src/modules/runner/code/index.mjs +2 -0
  188. package/dist/src/modules/runner/code/index.mjs.map +1 -0
  189. package/dist/src/modules/runner/index.js +10 -0
  190. package/dist/src/modules/runner/index.js.map +1 -0
  191. package/dist/src/modules/runner/index.mjs +5 -0
  192. package/dist/src/modules/runner/index.mjs.map +1 -0
  193. package/dist/src/modules/runner/json/index.js +8 -0
  194. package/dist/src/modules/runner/json/index.js.map +1 -0
  195. package/dist/src/modules/runner/json/index.mjs +2 -0
  196. package/dist/src/modules/runner/json/index.mjs.map +1 -0
  197. package/dist/src/modules/runner/json/json.js +20 -0
  198. package/dist/src/modules/runner/json/json.js.map +1 -0
  199. package/dist/src/modules/runner/json/json.mjs +17 -0
  200. package/dist/src/modules/runner/json/json.mjs.map +1 -0
  201. package/dist/src/modules/runner/json/transform.js +89 -0
  202. package/dist/src/modules/runner/json/transform.js.map +1 -0
  203. package/dist/src/modules/runner/json/transform.mjs +83 -0
  204. package/dist/src/modules/runner/json/transform.mjs.map +1 -0
  205. package/dist/src/modules/runner/runner.js +22 -0
  206. package/dist/src/modules/runner/runner.js.map +1 -0
  207. package/dist/src/modules/runner/runner.mjs +20 -0
  208. package/dist/src/modules/runner/runner.mjs.map +1 -0
  209. package/dist/src/modules/timer/constants.js +6 -0
  210. package/dist/src/modules/timer/constants.js.map +1 -0
  211. package/dist/src/modules/timer/constants.mjs +4 -0
  212. package/dist/src/modules/timer/constants.mjs.map +1 -0
  213. package/dist/src/modules/timer/index.js +10 -0
  214. package/dist/src/modules/timer/index.js.map +1 -0
  215. package/dist/src/modules/timer/index.mjs +4 -0
  216. package/dist/src/modules/timer/index.mjs.map +1 -0
  217. package/dist/src/modules/timer/timer.js +33 -0
  218. package/dist/src/modules/timer/timer.js.map +1 -0
  219. package/dist/src/modules/timer/timer.mjs +30 -0
  220. package/dist/src/modules/timer/timer.mjs.map +1 -0
  221. package/dist/src/modules/upgrader/constants.js +6 -0
  222. package/dist/src/modules/upgrader/constants.js.map +1 -0
  223. package/dist/src/modules/upgrader/constants.mjs +4 -0
  224. package/dist/src/modules/upgrader/constants.mjs.map +1 -0
  225. package/dist/src/modules/upgrader/index.js +10 -0
  226. package/dist/src/modules/upgrader/index.js.map +1 -0
  227. package/dist/src/modules/upgrader/index.mjs +4 -0
  228. package/dist/src/modules/upgrader/index.mjs.map +1 -0
  229. package/dist/src/modules/upgrader/upgrader.js +314 -0
  230. package/dist/src/modules/upgrader/upgrader.js.map +1 -0
  231. package/dist/src/modules/upgrader/upgrader.mjs +305 -0
  232. package/dist/src/modules/upgrader/upgrader.mjs.map +1 -0
  233. package/dist/src/modules/version/index.js +20 -0
  234. package/dist/src/modules/version/index.js.map +1 -0
  235. package/dist/src/modules/version/index.mjs +5 -0
  236. package/dist/src/modules/version/index.mjs.map +1 -0
  237. package/dist/src/modules/version/range.js +85 -0
  238. package/dist/src/modules/version/range.js.map +1 -0
  239. package/dist/src/modules/version/range.mjs +75 -0
  240. package/dist/src/modules/version/range.mjs.map +1 -0
  241. package/dist/src/modules/version/semver.js +30 -0
  242. package/dist/src/modules/version/semver.js.map +1 -0
  243. package/dist/src/modules/version/semver.mjs +20 -0
  244. package/dist/src/modules/version/semver.mjs.map +1 -0
  245. package/dist/src/modules/version/types.js +13 -0
  246. package/dist/src/modules/version/types.js.map +1 -0
  247. package/dist/src/modules/version/types.mjs +11 -0
  248. package/dist/src/modules/version/types.mjs.map +1 -0
  249. package/dist/src/tasks/codemods/list-codemods.js +40 -0
  250. package/dist/src/tasks/codemods/list-codemods.js.map +1 -0
  251. package/dist/src/tasks/codemods/list-codemods.mjs +38 -0
  252. package/dist/src/tasks/codemods/list-codemods.mjs.map +1 -0
  253. package/dist/src/tasks/codemods/run-codemods.js +36 -0
  254. package/dist/src/tasks/codemods/run-codemods.js.map +1 -0
  255. package/dist/src/tasks/codemods/run-codemods.mjs +34 -0
  256. package/dist/src/tasks/codemods/run-codemods.mjs.map +1 -0
  257. package/dist/src/tasks/codemods/utils.js +58 -0
  258. package/dist/src/tasks/codemods/utils.js.map +1 -0
  259. package/dist/src/tasks/codemods/utils.mjs +50 -0
  260. package/dist/src/tasks/codemods/utils.mjs.map +1 -0
  261. package/dist/src/tasks/index.js +14 -0
  262. package/dist/src/tasks/index.js.map +1 -0
  263. package/dist/src/tasks/index.mjs +6 -0
  264. package/dist/src/tasks/index.mjs.map +1 -0
  265. package/dist/src/tasks/upgrade/prompts/latest.js +48 -0
  266. package/dist/src/tasks/upgrade/prompts/latest.js.map +1 -0
  267. package/dist/src/tasks/upgrade/prompts/latest.mjs +46 -0
  268. package/dist/src/tasks/upgrade/prompts/latest.mjs.map +1 -0
  269. package/dist/src/tasks/upgrade/requirements/common.js +44 -0
  270. package/dist/src/tasks/upgrade/requirements/common.js.map +1 -0
  271. package/dist/src/tasks/upgrade/requirements/common.mjs +35 -0
  272. package/dist/src/tasks/upgrade/requirements/common.mjs.map +1 -0
  273. package/dist/src/tasks/upgrade/requirements/major.js +28 -0
  274. package/dist/src/tasks/upgrade/requirements/major.js.map +1 -0
  275. package/dist/src/tasks/upgrade/requirements/major.mjs +25 -0
  276. package/dist/src/tasks/upgrade/requirements/major.mjs.map +1 -0
  277. package/dist/src/tasks/upgrade/upgrade.js +73 -0
  278. package/dist/src/tasks/upgrade/upgrade.js.map +1 -0
  279. package/dist/src/tasks/upgrade/upgrade.mjs +67 -0
  280. package/dist/src/tasks/upgrade/upgrade.mjs.map +1 -0
  281. package/dist/tasks/codemods/list-codemods.d.ts.map +1 -1
  282. package/dist/tasks/codemods/run-codemods.d.ts.map +1 -1
  283. package/dist/tasks/codemods/utils.d.ts.map +1 -1
  284. package/dist/tasks/upgrade/prompts/index.d.ts +2 -0
  285. package/dist/tasks/upgrade/prompts/index.d.ts.map +1 -0
  286. package/dist/tasks/upgrade/prompts/latest.d.ts +9 -0
  287. package/dist/tasks/upgrade/prompts/latest.d.ts.map +1 -0
  288. package/dist/tasks/upgrade/requirements/major.d.ts.map +1 -1
  289. package/dist/tasks/upgrade/upgrade.d.ts.map +1 -1
  290. package/package.json +26 -20
  291. package/resources/codemods/5.0.0/comment-out-lifecycle-files.code.ts +63 -0
  292. package/resources/codemods/5.0.0/dependency-upgrade-react-and-react-dom.json.ts +67 -0
  293. package/resources/codemods/5.0.0/dependency-upgrade-styled-components.json.ts +49 -0
  294. package/resources/codemods/5.0.0/deprecate-helper-plugin.code.ts +192 -0
  295. package/resources/codemods/5.0.0/sqlite3-to-better-sqlite3.json.ts +0 -1
  296. package/resources/codemods/5.1.0/dependency-better-sqlite3.json.ts +48 -0
  297. package/resources/codemods/5.50.0/__tests__/vite-config-codemods.test.ts +215 -0
  298. package/resources/codemods/5.50.0/vite-config-manual-chunks-to-code-splitting.code.ts +118 -0
  299. package/resources/codemods/5.50.0/vite-config-remove-split-vendor-chunk-plugin.code.ts +75 -0
  300. package/resources/codemods/5.50.0/vite-config-rename-deprecated-options.code.ts +127 -0
  301. package/resources/codemods/5.50.0/vite-config-transform-with-esbuild-to-oxc.code.ts +61 -0
  302. package/resources/utils/change-import.ts +118 -0
  303. package/resources/utils/replace-jsx.ts +49 -0
package/LICENSE CHANGED
@@ -2,9 +2,23 @@ Copyright (c) 2015-present Strapi Solutions SAS
2
2
 
3
3
  Portions of the Strapi software are licensed as follows:
4
4
 
5
- - All software that resides under an "ee/" directory (the “EE Software”), if that directory exists, is licensed under the license defined in "ee/LICENSE".
5
+ * All software that resides under an "ee/" directory (the “EE Software”), if that directory exists, is licensed under the license defined below.
6
6
 
7
- - All software outside of the above-mentioned directories or restrictions above is available under the "MIT Expat" license as set forth below.
7
+ Enterprise License
8
+
9
+ If you or the company you represent has entered into a written agreement referencing the Enterprise Edition of the Strapi source code available at
10
+ https://github.com/strapi/strapi, then such agreement applies to your use of the Enterprise Edition of the Strapi Software. If you or the company you
11
+ represent is using the Enterprise Edition of the Strapi Software in connection with a subscription to our cloud offering, then the agreement you have
12
+ agreed to with respect to our cloud offering and the licenses included in such agreement apply to your use of the Enterprise Edition of the Strapi Software.
13
+ Otherwise, the Strapi Enterprise Software License Agreement (found here https://strapi.io/enterprise-terms) applies to your use of the Enterprise Edition of the Strapi Software.
14
+
15
+ BY ACCESSING OR USING THE ENTERPRISE EDITION OF THE STRAPI SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE RELEVANT REFERENCED AGREEMENT.
16
+ IF YOU ARE NOT AUTHORIZED TO ACCEPT THESE TERMS ON BEHALF OF THE COMPANY YOU REPRESENT OR IF YOU DO NOT AGREE TO ALL OF THE RELEVANT TERMS AND CONDITIONS REFERENCED AND YOU
17
+ HAVE NOT OTHERWISE EXECUTED A WRITTEN AGREEMENT WITH STRAPI, YOU ARE NOT AUTHORIZED TO ACCESS OR USE OR ALLOW ANY USER TO ACCESS OR USE ANY PART OF
18
+ THE ENTERPRISE EDITION OF THE STRAPI SOFTWARE. YOUR ACCESS RIGHTS ARE CONDITIONAL ON YOUR CONSENT TO THE RELEVANT REFERENCED TERMS TO THE EXCLUSION OF ALL OTHER TERMS;
19
+ IF THE RELEVANT REFERENCED TERMS ARE CONSIDERED AN OFFER BY YOU, ACCEPTANCE IS EXPRESSLY LIMITED TO THE RELEVANT REFERENCED TERMS.
20
+
21
+ * All software outside of the above-mentioned directories or restrictions above is available under the "MIT Expat" license as set forth below.
8
22
 
9
23
  MIT Expat License
10
24
 
@@ -18,5 +32,6 @@ furnished to do so, subject to the following conditions:
18
32
  The above copyright notice and this permission notice shall be included in all
19
33
  copies or substantial portions of the Software.
20
34
 
21
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- SOFTWARE.
35
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
36
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
37
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
package/README.md CHANGED
@@ -6,20 +6,34 @@ The Strapi Upgrade Tool is the CLI for facilitating upgrades between Strapi vers
6
6
 
7
7
  It handles updating a project's package.json with the correct version of Strapi, running the package installer, and running suggested code transforms for breaking changes (in major versions).
8
8
 
9
- Once released, it will be the recommended way to update to any major, minor, and patch versions of Strapi instead of manually modifying package.json files.
9
+ It is the recommended way to update to any major, minor, and patch versions of Strapi instead of manually modifying package.json files.
10
10
 
11
11
  The tool offers the following commands:
12
12
 
13
13
  ```
14
- major [options] Upgrade to the next available major version of Strapi
15
- minor [options] Upgrade to the latest minor and patch version of Strapi for the
16
- current major
17
- patch [options] Upgrade to latest patch version of Strapi for the current major
18
- and minor
14
+ latest [options] Upgrade to the latest available version of Strapi
15
+ major [options] Upgrade to the next available major version of Strapi
16
+ minor [options] Upgrade to the latest minor and patch version of Strapi for the
17
+ current major
18
+ patch [options] Upgrade to latest patch version of Strapi for the current major
19
+ and minor
20
+ to <version> Upgrade to a specific version of Strapi
19
21
  codemods [options] Run a set of available codemods for the selected target version
20
22
  without updating the Strapi dependencies
21
23
  ```
22
24
 
25
+ When `latest` resolves to a version blocked by registry policies such as `min-release-age`, use `to` to target a specific published version instead:
26
+
27
+ ```bash
28
+ npx @strapi/upgrade to 5.42.0
29
+ ```
30
+
31
+ For pre-releases, pass `--codemods-target` to select which codemod set to run (defaults to the `major.minor.patch` portion of the target version):
32
+
33
+ ```bash
34
+ npx @strapi/upgrade to 5.0.0-beta.951 --codemods-target 5.0.0
35
+ ```
36
+
23
37
  ### What's a codemod / code transform?
24
38
 
25
39
  Codemods are a scripted way to refactor code. Here we are providing and running these scripts for users for any changes necessary in user code between Strapi versions.
@@ -39,17 +53,20 @@ Data migrations are not handled by the upgrade tool.
39
53
 
40
54
  For Strapi v4, no data migrations will be allowed and no support is planned (except in extenuating circumstances eg, a critical security issue somehow relating to the database shape)
41
55
 
42
- For Strapi v5, automated data migrations can be added in the `packages/core/database` package of the `v5/main` branch of this repo.
56
+ For Strapi v5, automated data migrations can be added in the `packages/core/database` package of the `develop` branch of this repo.
43
57
 
44
58
  ## Usage
45
59
 
46
- This package is not yet released, so currently it can be run on a project in the monorepo /examples directory with the following command:
60
+ Run from a Strapi project directory:
47
61
 
48
- `../../packages/utils/upgrade/bin/upgrade`
62
+ ```bash
63
+ npx @strapi/upgrade --help
64
+ npx @strapi/upgrade to 5.42.0
65
+ ```
49
66
 
50
- Run the command with the `--help` option to see all the available options.
67
+ Within a project that has Strapi installed, you can also use `strapi upgrade`.
51
68
 
52
- [Coming Soon] The Strapi Upgrade tool will be available using `npx @strapi/upgrade` and an alias for that within a project using `strapi upgrade`
69
+ For monorepo development against `/examples`, run `../../packages/utils/upgrade/bin/upgrade` from the example app directory.
53
70
 
54
71
  ## Writing a code transforms
55
72