create-zleap-app 0.10.0 → 0.10.2

package/templates/react-ts/scripts/zleap.mjs

@@ -2,7 +2,7 @@
 // 项目内的一键命令，封装 zleap-app CLI：
 //
 //   npm run login  [-- --target https://os.example.com]   浏览器授权，保存开发会话（自动续期，最长 30 天）
-//   npm run deploy [-- --no-build] [--no-install]          构建 → 检查 → 上传 private 版本 → 安装/切换到新版本
+//   npm run deploy [-- --no-build] [--no-install]          构建 → 检查 → 上传开发版本 → 安装/切换到新版本
 //   npm run status                                        查看本应用的安装、权限与可用版本
 //   npm run versions                                      列出全部成员上传的开发版本、当前线上版本和发布记录
 //   npm run release [-- --version-id <id>] [--notes 说明] [--yes]
@@ -140,7 +140,7 @@ async function login() {
   const result = cli(args, { capture: false });
   if (result.code !== 0) throw new StepError('登录未完成');
   writeJSON(configFile, { ...config, target });
-  ok('已登录，开发会话 30 分钟内有效');
+  ok('已登录：访问凭据自动续期，授权最长 30 天（到期或 auth logout 后重新登录）');
 }
 
 function publishedVersions() {
@@ -160,7 +160,17 @@ function checkDist() {
   return result.json;
 }
 
+/** 生成的项目用 Vite 7（Node.js 20.19+ / 22.12+）；旧 Node 上构建会报难懂的语法错误，先说清楚。 */
+function requireSupportedNode() {
+  const [major, minor] = process.versions.node.split('.').map(Number);
+  if (major > 22 || (major === 22 && minor >= 12) || (major === 20 && minor >= 19)) return;
+  throw new StepError(
+    `当前 Node.js ${process.versions.node} 无法构建本项目（需要 20.19+ 或 22.12+）。请升级 Node.js（例如 nvm install 22）后重试。`,
+  );
+}
+
 async function deploy() {
+  requireSupportedNode();
   const build = () => {
     if (has('no-build')) return;
     log('构建 dist/');
@@ -183,7 +193,8 @@ async function deploy() {
     report = checkDist();
   }
 
-  log('上传 private 版本');
+  // appid 应用的上传是只有应用成员可见的开发版本；旧 app_key 应用是本人 private。都不会直接给全企业用。
+  log('上传开发版本');
   const published = cli(['publish', 'dist']);
   if (published.code === 6) {
     const requestId = published.json?.request_id;
@@ -254,6 +265,11 @@ function finish(appId, installed, diagnosis = null) {
   // 步骤按实际出现的条目连续编号：有的步骤视情况省略，写死序号会出现「1、3」。
   const steps = [];
   if (installed) steps.push('从 zleapOS 启动台打开应用（已打开的窗口点「重新加载应用」）。');
+  if (hasBackgroundCapabilities(readJSON(manifestFile, {})) && diagnosis?.resource_preparation_required) {
+    steps.push(
+      `有云函数 / 后台能力：npx zleap-app prepare ${appId} --version-id ${readJSON(stateFile, {}).versionId ?? '<version_id>'} 签名并激活到开发环境（或在「云开发控制台」→ 版本管理下方「开发环境：云函数激活」操作），再在应用窗口「权限」里允许后台能力。`,
+    );
+  }
   if (!cloud || !cloud.dev || !cloud.databaseReady) {
     steps.push('开发环境或数据库还没就绪：打开「云开发控制台」选中本应用 → 概览，按提示「创建开发环境」/ 等数据库「已就绪」。');
   }
@@ -270,6 +286,12 @@ function finish(appId, installed, diagnosis = null) {
   console.log(`  （app_id=${appId}，状态记录在 .zleap/state.json）`);
 }
 
+/** manifest 里声明了 headless 后台能力（云函数等）。 */
+function hasBackgroundCapabilities(value) {
+  const provides = value?.runtime?.capabilities?.provides;
+  return Array.isArray(provides) && provides.some((item) => item?.execution === 'headless');
+}
+
 function currentAppId() {
   const appId = option('app-id') || readJSON(stateFile, {}).appId;
   if (!appId) throw new StepError('还没有部署记录，先运行 npm run deploy（或用 --app-id 指定）');

package/templates/react-ts/src/cloud/client.ts

@@ -6,11 +6,11 @@
  * - 环境由宿主决定：永远用 DYNAMIC_CURRENT_ENV，不要写死 'dev' / 'prod'。
  * - 每次读最多 100 条，用 skip 翻页；写入结果未知（COMMIT_UNKNOWN）时先重读核对，不要自动重试。
  */
-import { CloudError, zl, type Capabilities } from '@zleap-web/app-sdk';
+import { CloudError, zl, type Capabilities } from '@zleap-ai/app-sdk';
 
 export { CloudError };
 export type { Capabilities };
-export type { Document } from '@zleap-web/app-sdk';
+export type { Document } from '@zleap-ai/app-sdk';
 
 export type ConnectionState =
   | { status: 'connecting' }