@strapi/upgrade 0.0.0-experimental.626cf5324f21d318dee435c11cb3e08bb4c414b7 → 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 (295) hide show
  1. package/README.md +28 -11
  2. package/dist/cli.js +18 -1481
  3. package/dist/cli.js.map +1 -1
  4. package/dist/cli.mjs +14 -0
  5. package/dist/cli.mjs.map +1 -0
  6. package/dist/index.js +8 -1459
  7. package/dist/index.js.map +1 -1
  8. package/dist/index.mjs +4 -1452
  9. package/dist/index.mjs.map +1 -1
  10. package/dist/modules/codemod/codemod.d.ts.map +1 -1
  11. package/dist/modules/codemod-repository/constants.d.ts.map +1 -1
  12. package/dist/modules/codemod-repository/repository.d.ts.map +1 -1
  13. package/dist/modules/codemod-runner/codemod-runner.d.ts.map +1 -1
  14. package/dist/modules/error/utils.d.ts +8 -0
  15. package/dist/modules/error/utils.d.ts.map +1 -1
  16. package/dist/modules/file-scanner/scanner.d.ts.map +1 -1
  17. package/dist/modules/format/formats.d.ts.map +1 -1
  18. package/dist/modules/json/file.d.ts.map +1 -1
  19. package/dist/modules/json/transform-api.d.ts.map +1 -1
  20. package/dist/modules/logger/logger.d.ts +0 -1
  21. package/dist/modules/logger/logger.d.ts.map +1 -1
  22. package/dist/modules/logger/types.d.ts +0 -1
  23. package/dist/modules/logger/types.d.ts.map +1 -1
  24. package/dist/modules/npm/package.d.ts +9 -3
  25. package/dist/modules/npm/package.d.ts.map +1 -1
  26. package/dist/modules/project/project.d.ts.map +1 -1
  27. package/dist/modules/project/utils.d.ts.map +1 -1
  28. package/dist/modules/report/report.d.ts.map +1 -1
  29. package/dist/modules/requirement/requirement.d.ts.map +1 -1
  30. package/dist/modules/runner/code/code.d.ts.map +1 -1
  31. package/dist/modules/runner/json/json.d.ts.map +1 -1
  32. package/dist/modules/runner/json/transform.d.ts.map +1 -1
  33. package/dist/modules/upgrader/types.d.ts +6 -0
  34. package/dist/modules/upgrader/types.d.ts.map +1 -1
  35. package/dist/modules/upgrader/upgrader.d.ts +10 -0
  36. package/dist/modules/upgrader/upgrader.d.ts.map +1 -1
  37. package/dist/modules/version/range.d.ts.map +1 -1
  38. package/dist/modules/version/semver.d.ts +1 -1
  39. package/dist/modules/version/semver.d.ts.map +1 -1
  40. package/dist/modules/version/types.d.ts +7 -5
  41. package/dist/modules/version/types.d.ts.map +1 -1
  42. package/dist/package.json.js +6 -0
  43. package/dist/package.json.js.map +1 -0
  44. package/dist/package.json.mjs +4 -0
  45. package/dist/package.json.mjs.map +1 -0
  46. package/dist/src/cli/commands/codemods.js +116 -0
  47. package/dist/src/cli/commands/codemods.js.map +1 -0
  48. package/dist/src/cli/commands/codemods.mjs +108 -0
  49. package/dist/src/cli/commands/codemods.mjs.map +1 -0
  50. package/dist/src/cli/commands/upgrade.js +102 -0
  51. package/dist/src/cli/commands/upgrade.js.map +1 -0
  52. package/dist/src/cli/commands/upgrade.mjs +95 -0
  53. package/dist/src/cli/commands/upgrade.mjs.map +1 -0
  54. package/dist/src/cli/errors.js +22 -0
  55. package/dist/src/cli/errors.js.map +1 -0
  56. package/dist/src/cli/errors.mjs +16 -0
  57. package/dist/src/cli/errors.mjs.map +1 -0
  58. package/dist/src/cli/options.js +25 -0
  59. package/dist/src/cli/options.js.map +1 -0
  60. package/dist/src/cli/options.mjs +18 -0
  61. package/dist/src/cli/options.mjs.map +1 -0
  62. package/dist/src/modules/codemod/codemod.js +48 -0
  63. package/dist/src/modules/codemod/codemod.js.map +1 -0
  64. package/dist/src/modules/codemod/codemod.mjs +41 -0
  65. package/dist/src/modules/codemod/codemod.mjs.map +1 -0
  66. package/dist/src/modules/codemod/constants.js +17 -0
  67. package/dist/src/modules/codemod/constants.js.map +1 -0
  68. package/dist/src/modules/codemod/constants.mjs +11 -0
  69. package/dist/src/modules/codemod/constants.mjs.map +1 -0
  70. package/dist/src/modules/codemod/index.js +10 -0
  71. package/dist/src/modules/codemod/index.js.map +1 -0
  72. package/dist/src/modules/codemod/index.mjs +4 -0
  73. package/dist/src/modules/codemod/index.mjs.map +1 -0
  74. package/dist/src/modules/codemod-repository/constants.js +13 -0
  75. package/dist/src/modules/codemod-repository/constants.js.map +1 -0
  76. package/dist/src/modules/codemod-repository/constants.mjs +7 -0
  77. package/dist/src/modules/codemod-repository/constants.mjs.map +1 -0
  78. package/dist/src/modules/codemod-repository/index.js +10 -0
  79. package/dist/src/modules/codemod-repository/index.js.map +1 -0
  80. package/dist/src/modules/codemod-repository/index.mjs +4 -0
  81. package/dist/src/modules/codemod-repository/index.mjs.map +1 -0
  82. package/dist/src/modules/codemod-repository/repository.js +133 -0
  83. package/dist/src/modules/codemod-repository/repository.js.map +1 -0
  84. package/dist/src/modules/codemod-repository/repository.mjs +122 -0
  85. package/dist/src/modules/codemod-repository/repository.mjs.map +1 -0
  86. package/dist/src/modules/codemod-runner/codemod-runner.js +112 -0
  87. package/dist/src/modules/codemod-runner/codemod-runner.js.map +1 -0
  88. package/dist/src/modules/codemod-runner/codemod-runner.mjs +109 -0
  89. package/dist/src/modules/codemod-runner/codemod-runner.mjs.map +1 -0
  90. package/dist/src/modules/error/index.js +11 -0
  91. package/dist/src/modules/error/index.js.map +1 -0
  92. package/dist/src/modules/error/index.mjs +2 -0
  93. package/dist/src/modules/error/index.mjs.map +1 -0
  94. package/dist/src/modules/error/utils.js +33 -0
  95. package/dist/src/modules/error/utils.js.map +1 -0
  96. package/dist/src/modules/error/utils.mjs +28 -0
  97. package/dist/src/modules/error/utils.mjs.map +1 -0
  98. package/dist/src/modules/file-scanner/index.js +8 -0
  99. package/dist/src/modules/file-scanner/index.js.map +1 -0
  100. package/dist/src/modules/file-scanner/index.mjs +2 -0
  101. package/dist/src/modules/file-scanner/index.mjs.map +1 -0
  102. package/dist/src/modules/file-scanner/scanner.js +28 -0
  103. package/dist/src/modules/file-scanner/scanner.js.map +1 -0
  104. package/dist/src/modules/file-scanner/scanner.mjs +20 -0
  105. package/dist/src/modules/file-scanner/scanner.mjs.map +1 -0
  106. package/dist/src/modules/format/formats.js +112 -0
  107. package/dist/src/modules/format/formats.js.map +1 -0
  108. package/dist/src/modules/format/formats.mjs +94 -0
  109. package/dist/src/modules/format/formats.mjs.map +1 -0
  110. package/dist/src/modules/format/index.js +19 -0
  111. package/dist/src/modules/format/index.js.map +1 -0
  112. package/dist/src/modules/format/index.mjs +2 -0
  113. package/dist/src/modules/format/index.mjs.map +1 -0
  114. package/dist/src/modules/index.js +32 -0
  115. package/dist/src/modules/index.js.map +1 -0
  116. package/dist/src/modules/index.mjs +27 -0
  117. package/dist/src/modules/index.mjs.map +1 -0
  118. package/dist/src/modules/json/file.js +20 -0
  119. package/dist/src/modules/json/file.js.map +1 -0
  120. package/dist/src/modules/json/file.mjs +13 -0
  121. package/dist/src/modules/json/file.mjs.map +1 -0
  122. package/dist/src/modules/json/transform-api.js +38 -0
  123. package/dist/src/modules/json/transform-api.js.map +1 -0
  124. package/dist/src/modules/json/transform-api.mjs +35 -0
  125. package/dist/src/modules/json/transform-api.mjs.map +1 -0
  126. package/dist/src/modules/logger/index.js +8 -0
  127. package/dist/src/modules/logger/index.js.map +1 -0
  128. package/dist/src/modules/logger/index.mjs +2 -0
  129. package/dist/src/modules/logger/index.mjs.map +1 -0
  130. package/dist/src/modules/logger/logger.js +80 -0
  131. package/dist/src/modules/logger/logger.js.map +1 -0
  132. package/dist/src/modules/logger/logger.mjs +73 -0
  133. package/dist/src/modules/logger/logger.mjs.map +1 -0
  134. package/dist/src/modules/npm/constants.js +6 -0
  135. package/dist/src/modules/npm/constants.js.map +1 -0
  136. package/dist/src/modules/npm/constants.mjs +4 -0
  137. package/dist/src/modules/npm/constants.mjs.map +1 -0
  138. package/dist/src/modules/npm/package.js +143 -0
  139. package/dist/src/modules/npm/package.js.map +1 -0
  140. package/dist/src/modules/npm/package.mjs +134 -0
  141. package/dist/src/modules/npm/package.mjs.map +1 -0
  142. package/dist/src/modules/project/constants.js +45 -0
  143. package/dist/src/modules/project/constants.js.map +1 -0
  144. package/dist/src/modules/project/constants.mjs +35 -0
  145. package/dist/src/modules/project/constants.mjs.map +1 -0
  146. package/dist/src/modules/project/index.js +15 -0
  147. package/dist/src/modules/project/index.js.map +1 -0
  148. package/dist/src/modules/project/index.mjs +5 -0
  149. package/dist/src/modules/project/index.mjs.map +1 -0
  150. package/dist/src/modules/project/project.js +212 -0
  151. package/dist/src/modules/project/project.js.map +1 -0
  152. package/dist/src/modules/project/project.mjs +200 -0
  153. package/dist/src/modules/project/project.mjs.map +1 -0
  154. package/dist/src/modules/project/utils.js +26 -0
  155. package/dist/src/modules/project/utils.js.map +1 -0
  156. package/dist/src/modules/project/utils.mjs +21 -0
  157. package/dist/src/modules/project/utils.mjs.map +1 -0
  158. package/dist/src/modules/report/index.js +9 -0
  159. package/dist/src/modules/report/index.js.map +1 -0
  160. package/dist/src/modules/report/index.mjs +2 -0
  161. package/dist/src/modules/report/index.mjs.map +1 -0
  162. package/dist/src/modules/report/report.js +13 -0
  163. package/dist/src/modules/report/report.js.map +1 -0
  164. package/dist/src/modules/report/report.mjs +10 -0
  165. package/dist/src/modules/report/report.mjs.map +1 -0
  166. package/dist/src/modules/requirement/index.js +8 -0
  167. package/dist/src/modules/requirement/index.js.map +1 -0
  168. package/dist/src/modules/requirement/index.mjs +2 -0
  169. package/dist/src/modules/requirement/index.mjs.map +1 -0
  170. package/dist/src/modules/requirement/requirement.js +55 -0
  171. package/dist/src/modules/requirement/requirement.js.map +1 -0
  172. package/dist/src/modules/requirement/requirement.mjs +52 -0
  173. package/dist/src/modules/requirement/requirement.mjs.map +1 -0
  174. package/dist/src/modules/runner/code/code.js +20 -0
  175. package/dist/src/modules/runner/code/code.js.map +1 -0
  176. package/dist/src/modules/runner/code/code.mjs +17 -0
  177. package/dist/src/modules/runner/code/code.mjs.map +1 -0
  178. package/dist/src/modules/runner/code/index.js +8 -0
  179. package/dist/src/modules/runner/code/index.js.map +1 -0
  180. package/dist/src/modules/runner/code/index.mjs +2 -0
  181. package/dist/src/modules/runner/code/index.mjs.map +1 -0
  182. package/dist/src/modules/runner/index.js +10 -0
  183. package/dist/src/modules/runner/index.js.map +1 -0
  184. package/dist/src/modules/runner/index.mjs +5 -0
  185. package/dist/src/modules/runner/index.mjs.map +1 -0
  186. package/dist/src/modules/runner/json/index.js +8 -0
  187. package/dist/src/modules/runner/json/index.js.map +1 -0
  188. package/dist/src/modules/runner/json/index.mjs +2 -0
  189. package/dist/src/modules/runner/json/index.mjs.map +1 -0
  190. package/dist/src/modules/runner/json/json.js +20 -0
  191. package/dist/src/modules/runner/json/json.js.map +1 -0
  192. package/dist/src/modules/runner/json/json.mjs +17 -0
  193. package/dist/src/modules/runner/json/json.mjs.map +1 -0
  194. package/dist/src/modules/runner/json/transform.js +89 -0
  195. package/dist/src/modules/runner/json/transform.js.map +1 -0
  196. package/dist/src/modules/runner/json/transform.mjs +83 -0
  197. package/dist/src/modules/runner/json/transform.mjs.map +1 -0
  198. package/dist/src/modules/runner/runner.js +22 -0
  199. package/dist/src/modules/runner/runner.js.map +1 -0
  200. package/dist/src/modules/runner/runner.mjs +20 -0
  201. package/dist/src/modules/runner/runner.mjs.map +1 -0
  202. package/dist/src/modules/timer/constants.js +6 -0
  203. package/dist/src/modules/timer/constants.js.map +1 -0
  204. package/dist/src/modules/timer/constants.mjs +4 -0
  205. package/dist/src/modules/timer/constants.mjs.map +1 -0
  206. package/dist/src/modules/timer/index.js +10 -0
  207. package/dist/src/modules/timer/index.js.map +1 -0
  208. package/dist/src/modules/timer/index.mjs +4 -0
  209. package/dist/src/modules/timer/index.mjs.map +1 -0
  210. package/dist/src/modules/timer/timer.js +33 -0
  211. package/dist/src/modules/timer/timer.js.map +1 -0
  212. package/dist/src/modules/timer/timer.mjs +30 -0
  213. package/dist/src/modules/timer/timer.mjs.map +1 -0
  214. package/dist/src/modules/upgrader/constants.js +6 -0
  215. package/dist/src/modules/upgrader/constants.js.map +1 -0
  216. package/dist/src/modules/upgrader/constants.mjs +4 -0
  217. package/dist/src/modules/upgrader/constants.mjs.map +1 -0
  218. package/dist/src/modules/upgrader/index.js +10 -0
  219. package/dist/src/modules/upgrader/index.js.map +1 -0
  220. package/dist/src/modules/upgrader/index.mjs +4 -0
  221. package/dist/src/modules/upgrader/index.mjs.map +1 -0
  222. package/dist/src/modules/upgrader/upgrader.js +314 -0
  223. package/dist/src/modules/upgrader/upgrader.js.map +1 -0
  224. package/dist/src/modules/upgrader/upgrader.mjs +305 -0
  225. package/dist/src/modules/upgrader/upgrader.mjs.map +1 -0
  226. package/dist/src/modules/version/index.js +20 -0
  227. package/dist/src/modules/version/index.js.map +1 -0
  228. package/dist/src/modules/version/index.mjs +5 -0
  229. package/dist/src/modules/version/index.mjs.map +1 -0
  230. package/dist/src/modules/version/range.js +85 -0
  231. package/dist/src/modules/version/range.js.map +1 -0
  232. package/dist/src/modules/version/range.mjs +75 -0
  233. package/dist/src/modules/version/range.mjs.map +1 -0
  234. package/dist/src/modules/version/semver.js +30 -0
  235. package/dist/src/modules/version/semver.js.map +1 -0
  236. package/dist/src/modules/version/semver.mjs +20 -0
  237. package/dist/src/modules/version/semver.mjs.map +1 -0
  238. package/dist/src/modules/version/types.js +13 -0
  239. package/dist/src/modules/version/types.js.map +1 -0
  240. package/dist/src/modules/version/types.mjs +11 -0
  241. package/dist/src/modules/version/types.mjs.map +1 -0
  242. package/dist/src/tasks/codemods/list-codemods.js +40 -0
  243. package/dist/src/tasks/codemods/list-codemods.js.map +1 -0
  244. package/dist/src/tasks/codemods/list-codemods.mjs +38 -0
  245. package/dist/src/tasks/codemods/list-codemods.mjs.map +1 -0
  246. package/dist/src/tasks/codemods/run-codemods.js +36 -0
  247. package/dist/src/tasks/codemods/run-codemods.js.map +1 -0
  248. package/dist/src/tasks/codemods/run-codemods.mjs +34 -0
  249. package/dist/src/tasks/codemods/run-codemods.mjs.map +1 -0
  250. package/dist/src/tasks/codemods/utils.js +58 -0
  251. package/dist/src/tasks/codemods/utils.js.map +1 -0
  252. package/dist/src/tasks/codemods/utils.mjs +50 -0
  253. package/dist/src/tasks/codemods/utils.mjs.map +1 -0
  254. package/dist/src/tasks/index.js +14 -0
  255. package/dist/src/tasks/index.js.map +1 -0
  256. package/dist/src/tasks/index.mjs +6 -0
  257. package/dist/src/tasks/index.mjs.map +1 -0
  258. package/dist/src/tasks/upgrade/prompts/latest.js +48 -0
  259. package/dist/src/tasks/upgrade/prompts/latest.js.map +1 -0
  260. package/dist/src/tasks/upgrade/prompts/latest.mjs +46 -0
  261. package/dist/src/tasks/upgrade/prompts/latest.mjs.map +1 -0
  262. package/dist/src/tasks/upgrade/requirements/common.js +44 -0
  263. package/dist/src/tasks/upgrade/requirements/common.js.map +1 -0
  264. package/dist/src/tasks/upgrade/requirements/common.mjs +35 -0
  265. package/dist/src/tasks/upgrade/requirements/common.mjs.map +1 -0
  266. package/dist/src/tasks/upgrade/requirements/major.js +28 -0
  267. package/dist/src/tasks/upgrade/requirements/major.js.map +1 -0
  268. package/dist/src/tasks/upgrade/requirements/major.mjs +25 -0
  269. package/dist/src/tasks/upgrade/requirements/major.mjs.map +1 -0
  270. package/dist/src/tasks/upgrade/upgrade.js +73 -0
  271. package/dist/src/tasks/upgrade/upgrade.js.map +1 -0
  272. package/dist/src/tasks/upgrade/upgrade.mjs +67 -0
  273. package/dist/src/tasks/upgrade/upgrade.mjs.map +1 -0
  274. package/dist/tasks/codemods/list-codemods.d.ts.map +1 -1
  275. package/dist/tasks/codemods/run-codemods.d.ts.map +1 -1
  276. package/dist/tasks/codemods/utils.d.ts.map +1 -1
  277. package/dist/tasks/upgrade/prompts/index.d.ts +2 -0
  278. package/dist/tasks/upgrade/prompts/index.d.ts.map +1 -0
  279. package/dist/tasks/upgrade/prompts/latest.d.ts +9 -0
  280. package/dist/tasks/upgrade/prompts/latest.d.ts.map +1 -0
  281. package/dist/tasks/upgrade/requirements/major.d.ts.map +1 -1
  282. package/dist/tasks/upgrade/upgrade.d.ts.map +1 -1
  283. package/package.json +26 -20
  284. package/resources/codemods/5.0.0/deprecate-helper-plugin.code.ts +192 -0
  285. package/resources/codemods/5.0.0/sqlite3-to-better-sqlite3.json.ts +0 -1
  286. package/resources/codemods/5.1.0/dependency-better-sqlite3.json.ts +48 -0
  287. package/resources/codemods/5.50.0/__tests__/vite-config-codemods.test.ts +215 -0
  288. package/resources/codemods/5.50.0/vite-config-manual-chunks-to-code-splitting.code.ts +118 -0
  289. package/resources/codemods/5.50.0/vite-config-remove-split-vendor-chunk-plugin.code.ts +75 -0
  290. package/resources/codemods/5.50.0/vite-config-rename-deprecated-options.code.ts +127 -0
  291. package/resources/codemods/5.50.0/vite-config-transform-with-esbuild-to-oxc.code.ts +61 -0
  292. package/resources/utils/change-import.ts +23 -10
  293. package/resources/codemods/5.0.0/change-useAPIErrorHandler-import.code.ts +0 -21
  294. package/resources/codemods/5.0.0/nocontent-migrate-to-emptystatelayout.code.ts +0 -30
  295. package/resources/codemods/5.0.0/useRBAC-hook-import-change.code.ts +0 -21
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