@lovrabet/rabetbase-cli 2.5.3-beta.2 → 2.5.3-beta.4

package/templates/README.md

@@ -49,15 +49,55 @@ node lib/cli.js project create template-verify --template-source templates/proje
 使用尚未发布的 CLI 时，先执行 `npm run build:dev`；
 使用已安装版本时，可把第二条命令换成 `rabetbase project create ...`。
 
-模板同步完成后，更新模板自身的 `package.json#version`，再生成待发布的 CDN 资产：
+模板源码确认后，可在开发阶段为单个通道生成快照；正式发布由 release 事务使用
+`deploy:verify` 已解析的精确版本自动生成，不要求开发者提前修改 `package.json#version`。
 
 ```bash
-npm run sync:cdn
+# 开发阶段：更新顶层 projectTemplate 与正式本地快照
+npm run sync:cdn -- --version <stable-version>
+
+# 开发阶段：只更新 beta.projectTemplate 与 beta 本地快照
+npm run sync:cdn:beta -- --version <beta-version>
+
+# 上传前组装：校验仓内两个快照并原子生成完整 dist 目录，不推进任一通道
+npm run sync:cdn:all
+
+# 只读校验：发布门禁会按目标自动执行其中一条
+npm run check:cdn
+npm run check:cdn:beta
+npm run check:cdn:all
+```
+
+`sync:cdn` 与 `sync:cdn:beta` 从同一个模板真源重新生成所选通道；写入快照必须显式提供候选
+版本，正式与 beta 快照可以不同，两个命令都不会推进另一通道。发布门禁通过
+`--version <resolved-version>` 只读验证将要发布的
+描述，release 事务再使用同一版本落盘。`sync:cdn:all` 只验证仓内已有快照并组装完整 `dist/`。
+唯一配置索引写入
+`dist/rabetbase-cli/config/index.json`，并覆盖发布到
+`https://g.lovrabet.com/dist/rabetbase-cli/config/index.json`。正式模板使用顶层
+`projectTemplate`，beta 模板使用 `beta.projectTemplate`。仓内正式文件
+`sub-app-react-demo.zip` 与 beta 文件 `sub-app-react-demo-beta.zip` 只是固定本地快照名；远端新发布
+文件统一为 `sub-app-react-demo-<version>.zip`。beta 描述缺失时继续兼容读取顶层正式模板。
+每个模板描述包含 CLI `version`、文件 `name`、从 `/dist/...` 开始的完整相对 `url`、`sha256`
+和 `size`；`name` 与 `url` 指向同一版本化文件，旧 CLI 按 `name`、新版 CLI 按 `url` 下载并
+校验大小与摘要。线上已有固定文件名描述继续兼容读取。CLI 使用
+当前国家/地区或独立部署路由中的 `cdn.lovrabet` 作为 host。CLI 更新策略与项目模板共用这个
+固定配置索引，beta 同步只更新 `beta.projectTemplate`。
+`check:cdn` / `check:cdn:beta` 在系统临时目录重建 ZIP，只读比对所选通道的描述、当前 CLI 版本
+和仓内归档；`check:cdn:all` 只检查两个已提交快照各自自洽。三者都不会改动 `cdn/` 或 `dist/`。
+
+生成目录包含固定配置索引和所选通道当前描述指向的模板。正常发布不上传整个目录；release
+脚本先上传单个不可变版本 ZIP，再发布 npm，最后单独覆盖固定配置索引：
+
+```bash
+yt upload dist/rabetbase-cli/templates/projects/sub-app-react-demo-<version>.zip -r all -force
+yt upload dist/rabetbase-cli/config/index.json -r all -force
 ```
 
-该命令会在 `dist/rabetbase-cli/templates/projects/` 下生成
-`sub-app-react-demo.zip`，并把版本、文件名、大小和 SHA-256 写入现有
-`dist/rabetbase-cli/config/index.json`。ZIP 使用固定地址，每次发布直接覆盖。
+以上顺序由 release 脚本执行，不作为日常手工步骤。必须向所有可用国家/地区发布并分别回读
+配置和 ZIP；新增节点由统一路由中的 `cdn.lovrabet` 提供 host，不在 CDN 配置里维护重复映射。
+release 脚本还会在 prepare 阶段记录两个 CDN 节点一致的共享配置摘要，并在归档上传和 config
+切换前重新校验；另一通道、CLI policy 或配置摘要发生变化时停止发布，不覆盖较新的线上事实。
 
 ### 模板结构
 
@@ -81,7 +121,7 @@ npm run sync:cdn
 ## 注意事项
 
 - `templates/projects/sub-app-react-demo/` 是项目模板真源，不是独立 Git 仓，也不是外部仓快照
-- `rabetbase project create` 从 CDN 下载 ZIP，然后更新 `package.json` 与 `.rabetbase.json`；此仓库模板不进入 npm 发布包
+- `rabetbase project create` 固定读取统一配置索引，再从描述中的正式或 beta URL 下载 ZIP，校验大小与 SHA-256 后更新 `package.json` 与 `.rabetbase.json`；正式 CLI 读取顶层模板，beta CLI 优先读取 `beta.projectTemplate`；此仓库模板不进入 npm 发布包
 - 模板文件名必须兼容 Windows、macOS 和 Linux；禁止符号链接、大小写冲突路径和 Windows 保留名称
 - 有 AppCode 时，CLI 会重新生成 `src/api/api.ts` 和 `src/api/client.ts`
 - 项目模板中不要保留真实 AppCode、真实数据集模型、`.git`、`node_modules`、`dist` 或个人配置

package/templates/generate-api/model-runtime.ts.tpl

@@ -0,0 +1,101 @@
+/**
+ * Profile-aware model selection generated by Rabetbase CLI.
+ * Do not add application-specific Dataset codes to this file.
+ */
+
+import type { ModelsConfig } from "@lovrabet/sdk";
+
+interface ModelProfile {
+  appCode: string;
+  runtimeDomain: string;
+}
+
+interface ModelEntryMetadata {
+  alias: string;
+  tableName: string;
+  name: string;
+}
+
+type ModelEntry = ModelEntryMetadata &
+  (
+    | { datasetCode: string; datasetCodes?: never }
+    | { datasetCode?: never; datasetCodes: Record<string, string> }
+  );
+
+interface ModelRegistry {
+  defaultProfile: string;
+  profiles: Record<string, ModelProfile>;
+  models: readonly ModelEntry[];
+}
+
+function normalizeDomain(value: string | undefined): string | undefined {
+  return value?.trim().replace(/\/+$/, "");
+}
+
+function injectedRuntimeDomain(): string | undefined {
+  if (typeof window === "undefined") return undefined;
+  const globalWindow = window as Window & {
+    __GLOBAL__?: {
+      deploymentConfig?: { RUNTIME_API_DOMAIN?: string };
+    };
+  };
+  return normalizeDomain(
+    globalWindow.__GLOBAL__?.deploymentConfig?.RUNTIME_API_DOMAIN,
+  );
+}
+
+function selectProfile(
+  registry: ModelRegistry,
+  projectRuntimeDomain: string,
+): readonly [string, ModelProfile] {
+  const runtimeDomain =
+    injectedRuntimeDomain() ?? normalizeDomain(projectRuntimeDomain);
+  const matches = Object.entries(registry.profiles).filter(
+    ([, profile]) => normalizeDomain(profile.runtimeDomain) === runtimeDomain,
+  );
+
+  if (matches.length > 1) {
+    throw new Error(
+      `Multiple Lovrabet model profiles match Runtime Domain "${runtimeDomain}". ` +
+        "Give each profile a distinct Runtime Domain.",
+    );
+  }
+  if (matches.length === 1) return matches[0]!;
+
+  throw new Error(
+    `No Lovrabet model profile matches Runtime Domain "${runtimeDomain ?? "(not set)"}". ` +
+      "Run `rabetbase api pull` after verifying the current project routing.",
+  );
+}
+
+export function resolveActiveModelConfig(
+  registry: ModelRegistry,
+  projectRuntimeDomain: string,
+): {
+  profileName: string;
+  appCode: string;
+  runtimeDomain: string;
+  modelsConfig: ModelsConfig;
+} {
+  const [profileName, profile] = selectProfile(registry, projectRuntimeDomain);
+  const models = registry.models.flatMap((model) => {
+    const datasetCode = model.datasetCode ?? model.datasetCodes?.[profileName];
+    return datasetCode
+      ? [
+          {
+            datasetCode,
+            tableName: model.tableName,
+            name: model.name,
+            alias: model.alias,
+          },
+        ]
+      : [];
+  });
+
+  return {
+    profileName,
+    appCode: profile.appCode,
+    runtimeDomain: profile.runtimeDomain,
+    modelsConfig: { appCode: profile.appCode, models },
+  };
+}

package/templates/generate-api/profile-api.ts.tpl

@@ -0,0 +1,21 @@
+/**
+ * Stable Lovrabet SDK model entrypoint.
+ * Generated by Rabetbase CLI.
+ */
+
+import { registerModels, CONFIG_NAMES } from "@lovrabet/sdk";
+import projectRouting from "{ProjectRoutingImport}";
+import { LOVRABET_MODEL_REGISTRY } from "./models.generated";
+import { resolveActiveModelConfig } from "./model-runtime";
+
+const activeModelConfig = resolveActiveModelConfig(
+  LOVRABET_MODEL_REGISTRY,
+  projectRouting.domains.runtime,
+);
+
+export const LOVRABET_PROFILE_NAME = activeModelConfig.profileName;
+export const LOVRABET_APP_CODE = activeModelConfig.appCode;
+export const LOVRABET_RUNTIME_DOMAIN = activeModelConfig.runtimeDomain;
+export const LOVRABET_MODELS_CONFIG = activeModelConfig.modelsConfig;
+
+registerModels(LOVRABET_MODELS_CONFIG, CONFIG_NAMES.DEFAULT);

package/templates/generate-api/profile-client.ts.tpl

@@ -0,0 +1,14 @@
+/**
+ * Stable Lovrabet SDK client entrypoint.
+ * Generated by Rabetbase CLI.
+ */
+
+import { createClient, CONFIG_NAMES } from "@lovrabet/sdk";
+import { LOVRABET_RUNTIME_DOMAIN } from "./api";
+import { LOVRABET_SDK_CONFIG } from "./sdk-config";
+
+export const lovrabetClient = createClient({
+  apiConfigName: CONFIG_NAMES.DEFAULT,
+  ...LOVRABET_SDK_CONFIG,
+  runtimeDomain: LOVRABET_RUNTIME_DOMAIN,
+});