@lark-apaas/fullstack-cli 1.1.70 → 1.1.71-alpha.20261103025257
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.
- package/README.md +10 -0
- package/dist/index.js +637 -235
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -19,6 +19,16 @@ npm install --save-dev @lark-apaas/fullstack-cli
|
|
|
19
19
|
|
|
20
20
|
## 使用
|
|
21
21
|
|
|
22
|
+
### DataPaaS SDK 与 Drizzle 同步升级
|
|
23
|
+
|
|
24
|
+
`fullstack-cli upgrade deps` 升级 NestJS/Express DataPaaS SDK 时，会先读取目标 SDK 已发布的 `peerDependencies.drizzle-orm`，同步迁移应用的精确 Drizzle 依赖。默认升级、`--version` 和灰度目标均使用各自 SDK 的契约；升级到旧 SDK 时不会强制安装 `0.45.2`。
|
|
25
|
+
|
|
26
|
+
迁移先备份应用的 `package.json`、`package-lock.json` 和 `node_modules`，仅重解受影响 SDK/Drizzle 的锁记录，再执行原生 `npm ci`。所有 npm 命令保留应用原目录及 `.npmrc`；不使用 `--force` 或 `--legacy-peer-deps`。原来放在 `devDependencies` 中的 Drizzle 保留原位置，缺少声明时添加到 `dependencies`。安装失败会恢复这三个备份；生命周期脚本对项目外部的副作用不在恢复范围内。
|
|
27
|
+
|
|
28
|
+
`--dry-run` 只读取元数据和展示计划。灰度目标 SDK 已安装但 Drizzle 声明或锁记录仍旧时也会修复；两者一致时不重复安装。`--packages` 排除的根 SDK 如果与新 peer 冲突，会在修改文件前报错，提示一起升级相关 SDK。无法解析契约、非精确 peer、npm shrinkwrap 或不支持的锁文件格式也会在迁移前停止。
|
|
29
|
+
|
|
30
|
+
在仓库中运行真实 npm 安装回归：`yarn workspace @lark-apaas/fullstack-cli test:peer-migration`。该测试启动临时本地 registry，覆盖旧应用升级、回滚到旧 SDK、灰度 peer 修复、锁文件重装及失败恢复，不访问生产 registry。
|
|
31
|
+
|
|
22
32
|
### 1. 自动派生
|
|
23
33
|
|
|
24
34
|
每次运行 `npm install` 时，会自动派生文件到项目：
|