@nocobase/plugin-flow-engine 2.1.0-beta.15 → 2.1.0-beta.16

package/dist/server/flow-surfaces/apply/layout.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { FlowSurfaceMutateOp, FlowSurfaceNodeSpec, FlowSurfaceWriteTarget } from '../types';
+type CompiledNodeRefLike = {
+    uidRef: any;
+};
+type SyncChildrenResultLike = {
+    childClientKeyRefs: Record<string, any>;
+    finalItemRefs: CompiledNodeRefLike[];
+    itemsChanged: boolean;
+    itemsSpecified: boolean;
+};
+export declare function omitLayoutProps(props?: Record<string, any>): Record<string, any>;
+export declare function buildAutoLayout(itemRefs: any[]): {
+    rows: {
+        [k: string]: any[][];
+    };
+    sizes: {
+        [k: string]: number[];
+    };
+    rowOrder: string[];
+};
+declare function didItemRefsChange(currentChildren: FlowSurfaceNodeSpec[], desiredRefs: CompiledNodeRefLike[]): boolean;
+export declare function emitLayoutOp(ops: FlowSurfaceMutateOp[], target: FlowSurfaceWriteTarget, currentNode: any, desiredNode: Pick<FlowSurfaceNodeSpec, 'props' | 'use'>, childSync: SyncChildrenResultLike): void;
+export declare function emitMoveOps(ops: FlowSurfaceMutateOp[], desiredRefs: CompiledNodeRefLike[]): void;
+export declare function emitMoveTabOps(ops: FlowSurfaceMutateOp[], desiredRefs: CompiledNodeRefLike[]): void;
+export declare function emitMovePopupTabOps(ops: FlowSurfaceMutateOp[], desiredRefs: CompiledNodeRefLike[]): void;
+export { didItemRefsChange };

package/dist/server/flow-surfaces/apply/layout.js

@@ -0,0 +1,175 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var layout_exports = {};
+__export(layout_exports, {
+  buildAutoLayout: () => buildAutoLayout,
+  didItemRefsChange: () => didItemRefsChange,
+  emitLayoutOp: () => emitLayoutOp,
+  emitMoveOps: () => emitMoveOps,
+  emitMovePopupTabOps: () => emitMovePopupTabOps,
+  emitMoveTabOps: () => emitMoveTabOps,
+  omitLayoutProps: () => omitLayoutProps
+});
+module.exports = __toCommonJS(layout_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_placement = require("../placement");
+function extractLayout(props) {
+  if (!props || !("rows" in props) && !("sizes" in props) && !("rowOrder" in props)) {
+    return null;
+  }
+  return {
+    rows: props.rows || {},
+    sizes: props.sizes || {},
+    rowOrder: props.rowOrder || Object.keys(props.rows || {})
+  };
+}
+function omitLayoutProps(props) {
+  if (!props) {
+    return props;
+  }
+  const next = import_lodash.default.omit(props, ["rows", "sizes", "rowOrder"]);
+  return Object.keys(next).length ? next : void 0;
+}
+function resolveLayoutRefs(layout, childClientKeyRefs) {
+  if (!layout) {
+    return layout;
+  }
+  return {
+    rows: Object.fromEntries(
+      Object.entries(layout.rows || {}).map(([rowId, cells]) => [
+        rowId,
+        import_lodash.default.castArray(cells).map(
+          (cell) => import_lodash.default.castArray(cell).map((itemUid) => childClientKeyRefs[itemUid] ?? itemUid)
+        )
+      ])
+    ),
+    sizes: layout.sizes || {},
+    rowOrder: layout.rowOrder || []
+  };
+}
+function hasRefValue(value) {
+  if (Array.isArray(value)) {
+    return value.some((item) => hasRefValue(item));
+  }
+  if (import_lodash.default.isPlainObject(value)) {
+    if (typeof value.ref === "string") {
+      return true;
+    }
+    return Object.values(value).some((item) => hasRefValue(item));
+  }
+  return false;
+}
+function buildAutoLayout(itemRefs) {
+  if (!itemRefs.length) {
+    return {
+      rows: {},
+      sizes: {},
+      rowOrder: []
+    };
+  }
+  return {
+    rows: Object.fromEntries(itemRefs.map((itemRef, index) => [`autoRow${index + 1}`, [[itemRef]]])),
+    sizes: Object.fromEntries(itemRefs.map((_2, index) => [`autoRow${index + 1}`, [24]])),
+    rowOrder: itemRefs.map((_2, index) => `autoRow${index + 1}`)
+  };
+}
+function didItemRefsChange(currentChildren, desiredRefs) {
+  if (currentChildren.length !== desiredRefs.length) {
+    return true;
+  }
+  return desiredRefs.some(
+    (item, index) => {
+      var _a;
+      return typeof item.uidRef !== "string" || ((_a = currentChildren[index]) == null ? void 0 : _a.uid) !== item.uidRef;
+    }
+  );
+}
+function emitLayoutOp(ops, target, currentNode, desiredNode, childSync) {
+  const explicitLayout = resolveLayoutRefs(extractLayout(desiredNode.props), childSync.childClientKeyRefs);
+  const desiredLayout = explicitLayout || ((0, import_placement.isGridUse)((currentNode == null ? void 0 : currentNode.use) || desiredNode.use) && childSync.itemsSpecified ? buildAutoLayout(childSync.finalItemRefs.map((item) => item.uidRef)) : null);
+  if (!desiredLayout) {
+    return;
+  }
+  if (!hasRefValue(desiredLayout) && import_lodash.default.isEqual(desiredLayout, extractLayout(currentNode == null ? void 0 : currentNode.props))) {
+    return;
+  }
+  ops.push({
+    type: "setLayout",
+    target,
+    values: desiredLayout
+  });
+}
+function emitMoveOps(ops, desiredRefs) {
+  for (let index = desiredRefs.length - 2; index >= 0; index -= 1) {
+    ops.push({
+      type: "moveNode",
+      values: {
+        sourceUid: desiredRefs[index].uidRef,
+        targetUid: desiredRefs[index + 1].uidRef,
+        position: "before"
+      }
+    });
+  }
+}
+function emitOrderedTabMoves(ops, desiredRefs, type) {
+  for (let index = desiredRefs.length - 2; index >= 0; index -= 1) {
+    ops.push({
+      type,
+      values: {
+        sourceUid: desiredRefs[index].uidRef,
+        targetUid: desiredRefs[index + 1].uidRef,
+        position: "before"
+      }
+    });
+  }
+}
+function emitMoveTabOps(ops, desiredRefs) {
+  emitOrderedTabMoves(ops, desiredRefs, "moveTab");
+}
+function emitMovePopupTabOps(ops, desiredRefs) {
+  emitOrderedTabMoves(ops, desiredRefs, "movePopupTab");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildAutoLayout,
+  didItemRefsChange,
+  emitLayoutOp,
+  emitMoveOps,
+  emitMovePopupTabOps,
+  emitMoveTabOps,
+  omitLayoutProps
+});

package/dist/server/flow-surfaces/apply/matching.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import type { FlowSurfaceApplySpec, FlowSurfaceNodeSpec } from '../types';
+export declare function normalizeChildren(input: any): FlowSurfaceNodeSpec[];
+export declare function hasExplicitSubModelKey(node: Pick<FlowSurfaceNodeSpec, 'subModels'> | FlowSurfaceApplySpec, key: string): any;
+export declare function matchesObjectChild(currentChild: any, desiredChild: FlowSurfaceNodeSpec): boolean;
+export declare function planArrayChildMatches(currentChildren: FlowSurfaceNodeSpec[], desiredChildren: FlowSurfaceNodeSpec[], parentUse: string, subKey: string): {
+    matchesByDesiredIndex: Map<number, FlowSurfaceNodeSpec>;
+    matchedCurrentUids: Set<string>;
+};

package/dist/server/flow-surfaces/apply/matching.js

@@ -0,0 +1,181 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var matching_exports = {};
+__export(matching_exports, {
+  hasExplicitSubModelKey: () => hasExplicitSubModelKey,
+  matchesObjectChild: () => matchesObjectChild,
+  normalizeChildren: () => normalizeChildren,
+  planArrayChildMatches: () => planArrayChildMatches
+});
+module.exports = __toCommonJS(matching_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_errors = require("../errors");
+function normalizeChildren(input) {
+  if (!input) {
+    return [];
+  }
+  return import_lodash.default.castArray(input).filter(Boolean);
+}
+function hasExplicitSubModelKey(node, key) {
+  return !!(node == null ? void 0 : node.subModels) && Object.prototype.hasOwnProperty.call(node.subModels, key);
+}
+function matchesObjectChild(currentChild, desiredChild) {
+  return currentChild.uid === desiredChild.uid || !desiredChild.uid && currentChild.use === desiredChild.use;
+}
+function planArrayChildMatches(currentChildren, desiredChildren, parentUse, subKey) {
+  const matchesByDesiredIndex = /* @__PURE__ */ new Map();
+  const matchedCurrentUids = /* @__PURE__ */ new Set();
+  const remainingDesiredByUse = /* @__PURE__ */ new Map();
+  for (const [desiredIndex, desiredChild] of desiredChildren.entries()) {
+    const matchedCurrent = findExactArrayChildMatch(currentChildren, desiredChild, matchedCurrentUids);
+    if (matchedCurrent) {
+      matchesByDesiredIndex.set(desiredIndex, matchedCurrent);
+      if (matchedCurrent.uid) {
+        matchedCurrentUids.add(matchedCurrent.uid);
+      }
+      continue;
+    }
+    if ((desiredChild == null ? void 0 : desiredChild.use) && !desiredChild.uid) {
+      const desiredIndexes = remainingDesiredByUse.get(desiredChild.use) || [];
+      desiredIndexes.push(desiredIndex);
+      remainingDesiredByUse.set(desiredChild.use, desiredIndexes);
+    }
+  }
+  const remainingCurrentByUse = /* @__PURE__ */ new Map();
+  for (const currentChild of currentChildren) {
+    if (!(currentChild == null ? void 0 : currentChild.use) || matchedCurrentUids.has(currentChild.uid || "")) {
+      continue;
+    }
+    const currentGroup = remainingCurrentByUse.get(currentChild.use) || [];
+    currentGroup.push(currentChild);
+    remainingCurrentByUse.set(currentChild.use, currentGroup);
+  }
+  const uses = /* @__PURE__ */ new Set([...remainingCurrentByUse.keys(), ...remainingDesiredByUse.keys()]);
+  for (const use of uses) {
+    const currentGroup = remainingCurrentByUse.get(use) || [];
+    const desiredIndexes = remainingDesiredByUse.get(use) || [];
+    const shouldReuseByOrder = currentGroup.length > 1 || desiredIndexes.length > 1;
+    if (currentGroup.length > 0 && desiredIndexes.length > 0 && currentGroup.length !== desiredIndexes.length && shouldReuseByOrder) {
+      throw new import_errors.FlowSurfaceBadRequestError(
+        `flowSurfaces apply cannot safely match duplicate '${use}' nodes under '${parentUse}.${subKey}' without explicit uid or signature`
+      );
+    }
+    if (!shouldReuseByOrder) {
+      continue;
+    }
+    const reuseCount = Math.min(currentGroup.length, desiredIndexes.length);
+    for (let index = 0; index < reuseCount; index += 1) {
+      const currentChild = currentGroup[index];
+      const desiredIndex = desiredIndexes[index];
+      matchesByDesiredIndex.set(desiredIndex, currentChild);
+      if (currentChild == null ? void 0 : currentChild.uid) {
+        matchedCurrentUids.add(currentChild.uid);
+      }
+    }
+  }
+  return {
+    matchesByDesiredIndex,
+    matchedCurrentUids
+  };
+}
+function findExactArrayChildMatch(currentChildren, desiredChild, matchedCurrent) {
+  if (desiredChild.uid) {
+    return currentChildren.find((item) => (item == null ? void 0 : item.uid) === desiredChild.uid);
+  }
+  const desiredStrongSignature = getStrongNodeSignature(desiredChild);
+  if (desiredStrongSignature) {
+    return currentChildren.find(
+      (item) => !matchedCurrent.has(item.uid || "") && getStrongNodeSignature(item) === desiredStrongSignature
+    );
+  }
+  const desiredWeakSignature = getWeakNodeSignature(desiredChild);
+  if (desiredWeakSignature) {
+    return currentChildren.find(
+      (item) => !matchedCurrent.has(item.uid || "") && getWeakNodeSignature(item) === desiredWeakSignature
+    );
+  }
+  return void 0;
+}
+function getStrongNodeSignature(node) {
+  if (!(node == null ? void 0 : node.use)) {
+    return null;
+  }
+  const resourceInit = import_lodash.default.get(node, ["stepParams", "resourceSettings", "init"]);
+  if ((resourceInit == null ? void 0 : resourceInit.dataSourceKey) || (resourceInit == null ? void 0 : resourceInit.collectionName) || (resourceInit == null ? void 0 : resourceInit.associationName) || (resourceInit == null ? void 0 : resourceInit.associationPathName) || !import_lodash.default.isUndefined(resourceInit == null ? void 0 : resourceInit.sourceId)) {
+    return [
+      "resource",
+      node.use,
+      resourceInit.dataSourceKey || "",
+      resourceInit.collectionName || "",
+      resourceInit.associationName || "",
+      resourceInit.associationPathName || "",
+      import_lodash.default.isUndefined(resourceInit.sourceId) ? "" : String(resourceInit.sourceId)
+    ].join(":");
+  }
+  const fieldInit = import_lodash.default.get(node, ["stepParams", "fieldSettings", "init"]) || import_lodash.default.get(node, ["subModels", "field", "stepParams", "fieldSettings", "init"]);
+  if (fieldInit == null ? void 0 : fieldInit.fieldPath) {
+    return [
+      "field",
+      node.use,
+      fieldInit.dataSourceKey || "",
+      fieldInit.collectionName || "",
+      fieldInit.associationPathName || "",
+      fieldInit.fieldPath
+    ].join(":");
+  }
+  if (node.use === "TableActionsColumnModel") {
+    return "slot:table-actions-column";
+  }
+  return null;
+}
+function getWeakNodeSignature(node) {
+  if (!(node == null ? void 0 : node.use)) {
+    return null;
+  }
+  const title = import_lodash.default.get(node, ["stepParams", "pageTabSettings", "tab", "title"]) || import_lodash.default.get(node, ["stepParams", "buttonSettings", "general", "title"]) || import_lodash.default.get(node, ["props", "title"]);
+  if (typeof title === "string" && title.trim()) {
+    return ["title", node.use, title.trim()].join(":");
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hasExplicitSubModelKey,
+  matchesObjectChild,
+  normalizeChildren,
+  planArrayChildMatches
+});

package/dist/server/flow-surfaces/approval/blueprint-service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import _ from 'lodash';
+import type FlowModelRepository from '../../repository';
+type FlowSurfaceApprovalBlueprintBindingResource = 'workflows' | 'flow_nodes';
+type ApprovalBlueprintServiceDeps = {
+    contractGuard: {
+        validateNodeTreeAgainstContract: (node: Record<string, any>) => void;
+    };
+    db: {
+        getRepository: (resourceName: string) => {
+            findOne: (options: Record<string, any>) => Promise<any>;
+            update: (options: Record<string, any>) => Promise<any>;
+        };
+    };
+    hasDataSource: (dataSourceKey: string) => boolean;
+    repository: Pick<FlowModelRepository, 'findModelById' | 'findModelByParentId' | 'insertModel' | 'upsertModel' | 'patch'>;
+    setNodeAsyncFlag: (uid: string, asyncFlag: boolean, transaction?: any) => Promise<void>;
+    removeNodeTreeWithBindings: (uid: string, transaction?: any) => Promise<void>;
+    surfaceContext: {
+        resolveGridNode: (uid: string, transaction?: any) => Promise<any>;
+    };
+    compose: (values: Record<string, any>, options: {
+        transaction?: any;
+    }) => Promise<any>;
+    addField: (values: Record<string, any>, options: {
+        transaction?: any;
+    }) => Promise<any>;
+    setLayout: (values: Record<string, any>, options: {
+        transaction?: any;
+    }) => Promise<any>;
+    get: (values: Record<string, any>, options: {
+        transaction?: any;
+    }) => Promise<any>;
+    buildComposeLayoutPayload: (input: {
+        layout: any;
+        createdByKey: Record<string, {
+            uid: string;
+        }>;
+        finalItems: any[];
+    }) => Record<string, any>;
+    syncApprovalRuntimeConfigForSurfaceRoot: (root: any, transaction?: any) => Promise<void>;
+};
+export declare class FlowSurfaceApprovalBlueprintService {
+    private readonly deps;
+    constructor(deps: ApprovalBlueprintServiceDeps);
+    private parseApprovalBlueprintCollection;
+    private resolveApprovalBlueprintBindingContext;
+    private buildApprovalBlueprintSurfaceRootTree;
+    private buildApprovalBlueprintPageSurfaceRootTree;
+    private getApprovalBlueprintExpectedTabUse;
+    private getApprovalBlueprintExpectedGridUse;
+    private findApprovalBlueprintSurfaceRoot;
+    private createApprovalBlueprintSurfaceRoot;
+    private ensureApprovalBlueprintPageSurfaceStructure;
+    private ensureApprovalBlueprintTaskCardSurfaceStructure;
+    private syncApprovalBlueprintSurfaceAsyncShape;
+    private syncApprovalBlueprintSurfaceRoot;
+    private ensureApprovalBlueprintSurfaceRoot;
+    private persistApprovalBlueprintBinding;
+    private applyApprovalBlueprintPageSurface;
+    private applyApprovalBlueprintTaskCardSurface;
+    applyApprovalBlueprint(values: Record<string, any>, options?: {
+        transaction?: any;
+    }): Promise<{
+        version: string;
+        mode: "replace";
+        surfaceType: "initiator" | "approver" | "taskCard";
+        target: _.Dictionary<any>;
+        binding: {
+            resourceName: FlowSurfaceApprovalBlueprintBindingResource;
+            filterByTk: string | number;
+            configPath: string;
+        };
+        surface: any;
+    }>;
+}
+export {};