@ldsg/cli 0.3.38 → 0.3.40

package/src/commands/resource/list.ts

@@ -137,7 +137,7 @@ export async function getTree(
         id: "__virtual_root__",
         kind: "virtual",
         parentId: null,
-        settings: { title: "Virtual Root" },
+        settings: { slug: "virtual-root", title: "Virtual Root", description: "" },
       };
       const childMap = buildChildMap(records);
       const children = roots.map((r) => buildTree(records, r.id)!).filter(Boolean);

package/src/commands/resource/mutate.ts

@@ -0,0 +1,542 @@
+import axios from "axios";
+import fs from "fs-extra";
+import { ResourceRecord, ResourceRecords, ResourceSettings } from "@ldsg/types";
+import {
+  DEFAULT_RRM_GRAPHQL_ENDPOINT,
+  DEFAULT_SOURCE_PATH,
+  RRM_FETCH_PAGE_SIZE,
+} from "../../constants";
+import { SourceData } from "../../types/resource-record";
+
+/**
+ * 与 @ldsg/console 的 purifyResourceRecords 一致：
+ * 发送前只保留 { id, kind, parentId, settings } 四个字段。
+ */
+export type MutateRecord = {
+  id: string;
+  kind: string;
+  parentId: string | null;
+  settings: Record<string, unknown>;
+};
+
+export type MutateRecordIdMap = Record<string, string>;
+
+export interface MutateOptions {
+  sourceData: SourceData;
+  /** GraphQL 端点，默认 https://api.rrm.ldsgy.com/graphql */
+  endpoint?: string;
+  /** Bearer token；不传则读取环境变量 RRM_ACCESS_TOKEN */
+  token?: string;
+  /** 可选：限定远端记录的作用范围（path regex，如应用 id） */
+  path?: string;
+  /** 是否软删除远端有、本地没有的记录（默认 true，对齐 console 全量同步） */
+  deleteMissing?: boolean;
+  /** 是否把线上分配的新 id 写回本地源文件（默认 true） */
+  writeBack?: boolean;
+  /** 存在软删除时是否跳过确认（默认 false） */
+  yes?: boolean;
+  /** 只计算 plan 不真正提交 */
+  dryRun?: boolean;
+}
+
+export interface MutatePlan {
+  /** 需要新建的记录（id 不在远端） */
+  createResourceRecords: MutateRecord[];
+  /** 需要更新的记录（id 已存在于远端） */
+  updateResourceRecords: MutateRecord[];
+  /** 需要软删除的记录（远端有、本地没有，settings.isDeleted=true） */
+  deleteResourceRecords: MutateRecord[];
+  /** 本次拉取到的远端记录数 */
+  remoteCount: number;
+  /** 本地记录数 */
+  localCount: number;
+}
+
+export interface MutateResult {
+  plan: MutatePlan;
+  dryRun: boolean;
+  /** 服务器实际返回的新建记录（含线上 id） */
+  createdResourceRecords: MutateRecord[];
+  /** 服务器实际返回的更新记录 */
+  updatedResourceRecords: MutateRecord[];
+  /** 本地临时 id -> 线上 id 映射（新建记录） */
+  idMap: MutateRecordIdMap;
+  /** 写回本地源文件的路径（仅本地文件源且非 dry-run 时存在） */
+  writeBackPath?: string;
+}
+
+export function purifyResourceRecord(record: ResourceRecord): MutateRecord {
+  return {
+    id: record.id,
+    kind: record.kind,
+    parentId: record.parentId ?? null,
+    settings: (record.settings ?? {}) as Record<string, unknown>,
+  };
+}
+
+/**
+ * 根据本地与远端记录拆分 create / update / delete(软删)。
+ * 对齐 console 的 mutateApplicationTreeResourceRecords 语义：
+ *   - 本地有、远端无  -> create
+ *   - 本地有、远端有  -> update
+ *   - 远端有、本地无  -> 软删除（settings.isDeleted = true，走 update）
+ */
+export function buildMutatePlan(
+  localRecords: ResourceRecords,
+  remoteRecords: ResourceRecords,
+  options: { deleteMissing?: boolean } = {},
+): MutatePlan {
+  const { deleteMissing = true } = options;
+
+  const remoteIdSet = new Set(remoteRecords.map((r) => r.id));
+  const localIdSet = new Set(localRecords.map((r) => r.id));
+
+  const createResourceRecords = localRecords
+    .filter((r) => !remoteIdSet.has(r.id))
+    .map(purifyResourceRecord);
+
+  const updateResourceRecords = localRecords
+    .filter((r) => remoteIdSet.has(r.id))
+    .map(purifyResourceRecord);
+
+  const deleteResourceRecords = deleteMissing
+    ? remoteRecords
+        .filter((r) => !localIdSet.has(r.id))
+        .map((r) => {
+          const purified = purifyResourceRecord(r);
+          return {
+            ...purified,
+            settings: { ...purified.settings, isDeleted: true },
+          };
+        })
+    : [];
+
+  return {
+    createResourceRecords,
+    updateResourceRecords,
+    deleteResourceRecords,
+    remoteCount: remoteRecords.length,
+    localCount: localRecords.length,
+  };
+}
+
+/**
+ * 递归替换任意 string 值（精确匹配 idMap 的 key）：
+ * 覆盖 id、parentId 以及 settings 中对其它临时 id 的引用
+ * （如 fieldTypeResourceId / workflowNodeTypeResourceId / objectResourceId 等）。
+ */
+export function replaceIdsDeep(value: unknown, idMap: MutateRecordIdMap): unknown {
+  if (typeof value === "string") {
+    return idMap[value] ?? value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => replaceIdsDeep(item, idMap));
+  }
+  if (value && typeof value === "object") {
+    const result: Record<string, unknown> = {};
+    for (const [key, item] of Object.entries(value as Record<string, unknown>)) {
+      result[key] = replaceIdsDeep(item, idMap);
+    }
+    return result;
+  }
+  return value;
+}
+
+/**
+ * 把本地记录里的临时 id 替换为线上 id（用于写回本地源文件）。
+ */
+export function applyIdMapToRecords(
+  records: ResourceRecords,
+  idMap: MutateRecordIdMap,
+): ResourceRecords {
+  return records.map((record) => replaceIdsDeep(record, idMap) as ResourceRecord);
+}
+
+function buildRemoteFilter(path?: string): Record<string, unknown> {
+  const filter: Record<string, unknown> = {
+    settings: { isDeleted: { $ne: true } },
+  };
+  if (path) {
+    filter._operators = { path: { regex: path } };
+  }
+  return filter;
+}
+
+/**
+ * 从 RRM 分页拉取远端记录（匿名可读，无需 token）。
+ */
+export async function fetchRemoteResourceRecords(options: {
+  endpoint: string;
+  token?: string;
+  path?: string;
+}): Promise<ResourceRecords> {
+  const { endpoint, token, path } = options;
+
+  const query = `
+    query ResourceRecordConnectionQuery(
+      $filter: FilterFindManyResourceRecordInput
+      $first: Int
+      $after: String
+    ) {
+      resourceRecordConnection(filter: $filter, first: $first, after: $after) {
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+        edges {
+          node {
+            id: _id
+            kind
+            parentId
+            settings
+          }
+        }
+      }
+    }
+  `;
+
+  const records: ResourceRecords = [];
+  let after: string | undefined;
+
+  while (true) {
+    const res = await axios.post(
+      endpoint,
+      {
+        query,
+        variables: {
+          filter: buildRemoteFilter(path),
+          first: RRM_FETCH_PAGE_SIZE,
+          ...(after ? { after } : {}),
+        },
+      },
+      {
+        headers: {
+          "Content-Type": "application/json",
+          ...(token ? { authorization: `Bearer ${token}` } : {}),
+        },
+        timeout: 60000,
+      },
+    );
+
+    if (res.data?.errors?.length > 0) {
+      throw new Error(
+        `RRM query failed: ${res.data.errors.map((e: { message: string }) => e.message).join("; ")}`,
+      );
+    }
+
+    const page = res.data?.data?.resourceRecordConnection;
+    if (!page) {
+      throw new Error("RRM query returned no resourceRecordConnection");
+    }
+
+    for (const edge of page.edges ?? []) {
+      records.push({
+        id: edge.node.id,
+        kind: edge.node.kind,
+        parentId: edge.node.parentId ?? null,
+        settings: (edge.node.settings ?? {}) as ResourceSettings,
+      });
+    }
+
+    if (!page.pageInfo?.hasNextPage) break;
+    after = page.pageInfo.endCursor ?? undefined;
+  }
+
+  return records;
+}
+
+/**
+ * 调用 RRM 的 mutateResourceRecords mutation（与 console 完全一致）。
+ */
+export async function mutateResourceRecords(options: {
+  endpoint: string;
+  token?: string;
+  createResourceRecords: MutateRecord[];
+  updateResourceRecords: MutateRecord[];
+}): Promise<{
+  createdResourceRecords: MutateRecord[];
+  updatedResourceRecords: MutateRecord[];
+}> {
+  const { endpoint, token, createResourceRecords, updateResourceRecords } = options;
+
+  const mutation = `
+    mutation MutateResourceRecordsMutation(
+      $createResourceRecords: JSON
+      $updateResourceRecords: JSON
+    ) {
+      mutateResourceRecords(
+        createResourceRecords: $createResourceRecords
+        updateResourceRecords: $updateResourceRecords
+      ) {
+        updatedResourceRecords
+        createdResourceRecords
+      }
+    }
+  `;
+
+  const res = await axios.post(
+    endpoint,
+    {
+      query: mutation,
+      variables: {
+        createResourceRecords,
+        updateResourceRecords,
+      },
+    },
+    {
+      headers: {
+        "Content-Type": "application/json",
+        ...(token ? { authorization: `Bearer ${token}` } : {}),
+      },
+      timeout: 120000,
+    },
+  );
+
+  if (res.data?.errors?.length > 0) {
+    throw new Error(
+      `RRM mutateResourceRecords failed: ${res.data.errors
+        .map((e: { message: string }) => e.message)
+        .join("; ")}`,
+    );
+  }
+
+  const data = res.data?.data?.mutateResourceRecords ?? {};
+
+  return {
+    createdResourceRecords: (data.createdResourceRecords ?? []) as MutateRecord[],
+    updatedResourceRecords: (data.updatedResourceRecords ?? []) as MutateRecord[],
+  };
+}
+
+/**
+ * 根据服务器返回的新建记录，构建 本地临时id -> 线上id 映射。
+ * createdResourceRecords 与 createResourceRecords 按数组下标对应；
+ * 若数量不一致则放弃映射（避免写坏本地文件）。
+ */
+export function buildIdMap(
+  localCreateRecords: MutateRecord[],
+  createdResourceRecords: MutateRecord[],
+): MutateRecordIdMap {
+  if (createdResourceRecords.length !== localCreateRecords.length) {
+    return {};
+  }
+
+  const idMap: MutateRecordIdMap = {};
+  for (let i = 0; i < localCreateRecords.length; i++) {
+    const localId = localCreateRecords[i].id;
+    const remoteId = createdResourceRecords[i].id;
+    if (localId !== remoteId) {
+      idMap[localId] = remoteId;
+    }
+  }
+  return idMap;
+}
+
+async function writeBackLocalFile(
+  sourceData: SourceData,
+  idMap: MutateRecordIdMap,
+): Promise<string | undefined> {
+  if (sourceData.filePath === "-stdin-") {
+    return undefined;
+  }
+  if (Object.keys(idMap).length === 0) {
+    return undefined;
+  }
+
+  const updatedRecords = applyIdMapToRecords(sourceData.resourceRecords, idMap);
+  const output =
+    sourceData.format === "array" ? updatedRecords : { resourceRecords: updatedRecords };
+  await fs.writeJson(sourceData.filePath, output, { spaces: 2 });
+  return sourceData.filePath;
+}
+
+/**
+ * mutate 自动模式：同步本地资源到 RRM
+ * 1. 拉取远端记录（可 --path 限定作用范围）
+ * 2. 拆分为 create / update / delete(软删)
+ * 3. 调用 mutateResourceRecords（需 Bearer token）
+ * 4. 把线上分配的新 id 写回本地源文件
+ */
+export async function mutateResources(options: MutateOptions): Promise<MutateResult> {
+  const {
+    sourceData,
+    endpoint = DEFAULT_RRM_GRAPHQL_ENDPOINT,
+    token,
+    path,
+    deleteMissing = true,
+    writeBack = true,
+    yes = false,
+    dryRun = false,
+  } = options;
+
+  const remoteRecords = await fetchRemoteResourceRecords({ endpoint, token, path });
+
+  const plan = buildMutatePlan(sourceData.resourceRecords, remoteRecords, { deleteMissing });
+
+  if (dryRun) {
+    return {
+      plan,
+      dryRun: true,
+      createdResourceRecords: [],
+      updatedResourceRecords: [],
+      idMap: {},
+    };
+  }
+
+  const hasWrites =
+    plan.createResourceRecords.length > 0 ||
+    plan.updateResourceRecords.length > 0 ||
+    plan.deleteResourceRecords.length > 0;
+
+  if (!hasWrites) {
+    return {
+      plan,
+      dryRun: false,
+      createdResourceRecords: [],
+      updatedResourceRecords: [],
+      idMap: {},
+    };
+  }
+
+  const effectiveToken = token || process.env.RRM_ACCESS_TOKEN;
+
+  if (!effectiveToken) {
+    throw new Error(
+      "RRM 写操作需要鉴权：请通过 --token 或环境变量 RRM_ACCESS_TOKEN 提供 Bearer token（console 登录后 localStorage 的 ACCESS_TOKEN）",
+    );
+  }
+
+  if (plan.deleteResourceRecords.length > 0 && !yes) {
+    throw new Error(
+      `本次将软删除 ${plan.deleteResourceRecords.length} 条远端记录（settings.isDeleted=true）。` +
+        "请先用 --dry-run 查看，确认后加 --yes 执行；或加 --no-delete-missing 关闭软删除。",
+    );
+  }
+
+  const updateResourceRecords = [...plan.updateResourceRecords, ...plan.deleteResourceRecords];
+
+  const { createdResourceRecords, updatedResourceRecords: returnedUpdated } =
+    await mutateResourceRecords({
+      endpoint,
+      token: effectiveToken,
+      createResourceRecords: plan.createResourceRecords,
+      updateResourceRecords,
+    });
+
+  const idMap = buildIdMap(plan.createResourceRecords, createdResourceRecords);
+
+  let writeBackPath: string | undefined;
+  if (writeBack) {
+    writeBackPath = await writeBackLocalFile(sourceData, idMap);
+  }
+
+  return {
+    plan,
+    dryRun: false,
+    createdResourceRecords,
+    updatedResourceRecords: returnedUpdated,
+    idMap,
+    writeBackPath,
+  };
+}
+
+export interface MutateRecordsDirectOptions {
+  endpoint?: string;
+  token?: string;
+  createResourceRecords: MutateRecord[];
+  updateResourceRecords: MutateRecord[];
+  dryRun?: boolean;
+}
+
+/**
+ * mutate 显式模式：把调用方明确给出的 create / update 记录直接提交给
+ * mutateResourceRecords（不拉远端、不自动拆分、不写回）。与 console 行为一致。
+ */
+export async function mutateRecordsDirect(options: MutateRecordsDirectOptions): Promise<{
+  dryRun: boolean;
+  createCount: number;
+  updateCount: number;
+  createdResourceRecords: MutateRecord[];
+  updatedResourceRecords: MutateRecord[];
+}> {
+  const {
+    endpoint = DEFAULT_RRM_GRAPHQL_ENDPOINT,
+    token,
+    createResourceRecords,
+    updateResourceRecords,
+    dryRun = false,
+  } = options;
+
+  const hasWrites = createResourceRecords.length > 0 || updateResourceRecords.length > 0;
+
+  if (!hasWrites) {
+    return {
+      dryRun,
+      createCount: 0,
+      updateCount: 0,
+      createdResourceRecords: [],
+      updatedResourceRecords: [],
+    };
+  }
+
+  if (dryRun) {
+    return {
+      dryRun: true,
+      createCount: createResourceRecords.length,
+      updateCount: updateResourceRecords.length,
+      createdResourceRecords: [],
+      updatedResourceRecords: [],
+    };
+  }
+
+  const effectiveToken = token || process.env.RRM_ACCESS_TOKEN;
+
+  if (!effectiveToken) {
+    throw new Error(
+      "RRM 写操作需要鉴权：请通过 --token 或环境变量 RRM_ACCESS_TOKEN 提供 Bearer token（console 登录后 localStorage 的 ACCESS_TOKEN）",
+    );
+  }
+
+  const { createdResourceRecords: created, updatedResourceRecords: updated } =
+    await mutateResourceRecords({
+      endpoint,
+      token: effectiveToken,
+      createResourceRecords,
+      updateResourceRecords,
+    });
+
+  return {
+    dryRun: false,
+    createCount: createResourceRecords.length,
+    updateCount: updateResourceRecords.length,
+    createdResourceRecords: created,
+    updatedResourceRecords: updated,
+  };
+}
+
+export interface PullRemoteResourceRecordsOptions {
+  endpoint?: string;
+  token?: string;
+  path?: string;
+  output?: string;
+}
+
+/**
+ * pull：把远端记录拉到本地文件（只读，无需 token）。
+ */
+export async function pullRemoteResourceRecords(
+  options: PullRemoteResourceRecordsOptions,
+): Promise<{ count: number; outputPath: string }> {
+  const {
+    endpoint = DEFAULT_RRM_GRAPHQL_ENDPOINT,
+    token,
+    path,
+    output = DEFAULT_SOURCE_PATH,
+  } = options;
+
+  const records = await fetchRemoteResourceRecords({ endpoint, token, path });
+
+  await fs.writeJson(output, records, { spaces: 2 });
+
+  return { count: records.length, outputPath: output };
+}

package/src/constants.ts

@@ -2,3 +2,7 @@ export const DEFAULT_OUTPUT_PATH = ".";
 
 export const DEFAULT_SOURCE_FILE = "resource-records.json";
 export const DEFAULT_SOURCE_PATH = `./${DEFAULT_SOURCE_FILE}`;
+
+export const DEFAULT_RRM_GRAPHQL_ENDPOINT = "https://api.rrm.ldsgy.com/graphql";
+export const RRM_ACCESS_TOKEN_ENV = "RRM_ACCESS_TOKEN";
+export const RRM_FETCH_PAGE_SIZE = 100;

package/src/types/get-extend-app-data-params.ts

@@ -1,8 +1,11 @@
 import { AppData } from "@ldsg/types";
-import { ExtendAppDataParams } from "@ldsg/utils";
+import { ExtendAppDataParams, ZipAppDataLayout } from "@ldsg/utils";
 
 interface GetExtendAppDataParamsParams {
   appData: AppData;
+  layout?: ZipAppDataLayout;
+  appPackageName?: string;
+  outputPath?: string;
 }
 
 export type GetExtendAppDataParams = (

package/src/utils/get-extend-app-data-params-using-workspace-ldsg-module/index.ts

@@ -1,10 +1,18 @@
 import { FILES_IN_APP_TEMPLATE_MODULE } from "@ldsg/constants";
-import { ExtendAppDataParams, RUSH_JSON_PATH, syncRushProjects } from "@ldsg/utils";
+import {
+  ExtendAppDataParams,
+  RUSH_JSON_PATH,
+  syncRushProjects,
+  ZipAppDataLayout,
+} from "@ldsg/utils";
 import fs from "fs-extra";
 import _ from "lodash";
+import path from "path";
 import { GetExtendAppDataParams } from "../../types/get-extend-app-data-params";
 
-const DEBUG_APP_PACKAGE_NAME = "@ldsg/app";
+const DEFAULT_APP_PACKAGE_NAME = "@ldsg/app";
+
+const DEFAULT_OUTPUT_PATH = "../../generated";
 
 /**
  * 主函数，用于准备调试应用环境
@@ -22,10 +30,17 @@ const DEBUG_APP_PACKAGE_NAME = "@ldsg/app";
 export const getExtendAppDataParamsUsingWorkspaceLdsgModule: GetExtendAppDataParams = async (
   params,
 ) => {
-  const { appData: paramsAppData } = params;
+  const {
+    appData: paramsAppData,
+    layout = ZipAppDataLayout.FLAT,
+    appPackageName = DEFAULT_APP_PACKAGE_NAME,
+    outputPath = DEFAULT_OUTPUT_PATH,
+  } = params;
 
   let appData = paramsAppData;
 
+  const handlerResourceIds = [];
+
   /**
    * 相对于普通应用准备，增加了如下操作
    * 1. ldsg 模块使用 workspace 模式
@@ -34,13 +49,25 @@ export const getExtendAppDataParamsUsingWorkspaceLdsgModule: GetExtendAppDataPar
   {
     const { resourceRecords: appDataResourceRecords } = appData;
 
+    const repoRoot = path.resolve(process.cwd(), "../..");
+    const outputAbs = path.resolve(process.cwd(), outputPath);
+    const outputRel = path.relative(repoRoot, outputAbs);
+
+    const appProjectFolder =
+      layout === ZipAppDataLayout.NESTED ? outputRel : path.join(outputRel, "app");
+
+    const getHandlerProjectFolder = (id: string) =>
+      layout === ZipAppDataLayout.NESTED
+        ? path.join(outputRel, "handlers", id)
+        : path.join(outputRel, id);
+
     const subspaceProjects: {
       packageName: string;
       projectFolder: string;
     }[] = [
       {
-        packageName: DEBUG_APP_PACKAGE_NAME,
-        projectFolder: "generated/app",
+        packageName: appPackageName,
+        projectFolder: appProjectFolder,
       },
     ];
 
@@ -51,9 +78,11 @@ export const getExtendAppDataParamsUsingWorkspaceLdsgModule: GetExtendAppDataPar
       const { id, kind } = resourceRecord;
 
       if (kind === "handler") {
+        handlerResourceIds.push(id);
+
         subspaceProjects.push({
           packageName: `${id}`,
-          projectFolder: `generated/${id}`,
+          projectFolder: getHandlerProjectFolder(id),
         });
 
         let dependencies = resourceRecord.settings.dependencies.map((dependency) => {
@@ -110,7 +139,14 @@ export const getExtendAppDataParamsUsingWorkspaceLdsgModule: GetExtendAppDataPar
 
   const packageJsonFile = FILES_IN_APP_TEMPLATE_MODULE.find((file) => file.path === "package.json");
 
-  _.set(packageJsonFile, "data.name", DEBUG_APP_PACKAGE_NAME);
+  _.set(packageJsonFile, "data.name", appPackageName);
+
+  const dependencies = {
+    ..._.get(packageJsonFile, "data.dependencies"),
+    ..._.mapValues(_.keyBy(handlerResourceIds), () => "workspace:*"),
+  };
+
+  _.set(packageJsonFile, "data.dependencies", dependencies);
 
   const res: ExtendAppDataParams = {
     appData,

package/.rush/temp/chunked-rush-logs/cli.format.chunks.jsonl

@@ -1,2 +0,0 @@
-{"kind":"O","text":"Invoking: oxfmt --write src/ \n"}
-{"kind":"O","text":"Finished in 89ms on 23 files using 4 threads.\n"}