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

package/templates/README.md

@@ -52,12 +52,24 @@ node lib/cli.js project create template-verify --template-source templates/proje
 模板同步完成后，更新模板自身的 `package.json#version`，再生成待发布的 CDN 资产：
 
 ```bash
+# 正式模板：更新顶层 projectTemplate
 npm run sync:cdn
+
+# beta 模板：只更新 beta.projectTemplate
+npm run sync:cdn:beta
+
+# 只读校验：发布门禁会按目标自动执行其中一条
+npm run check:cdn
+npm run check:cdn:beta
 ```
 
-该命令会在 `dist/rabetbase-cli/templates/projects/` 下生成
-`sub-app-react-demo.zip`，并把版本、文件名、大小和 SHA-256 写入现有
-`dist/rabetbase-cli/config/index.json`。ZIP 使用固定地址，每次发布直接覆盖。
+两个命令都只从同一个正式模板真源生成产物，并写入同一个
+`dist/rabetbase-cli/config/index.json`。正式模板使用顶层 `projectTemplate` 和
+`sub-app-react-demo.zip`；beta 模板使用 `beta.projectTemplate` 和
+`sub-app-react-demo-beta.zip`，两条发布通道互不覆盖。旧 CLI 继续读取顶层字段；
+新版 beta CLI 在 beta 描述缺失时兼容回退到顶层正式模板。
+`check:cdn` / `check:cdn:beta` 在系统临时目录重建 ZIP，只读比对模板描述和仓内归档，
+不会改动 `cdn/` 或 `dist/`。
 
 ### 模板结构
 
@@ -81,7 +93,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` 从 CDN 下载 ZIP，然后更新 `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,
+});