@gadmin2n/schematics 0.0.142 → 0.0.144

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/workflow-node-types.ts

@@ -1,4 +1,3 @@
-import { ALL_NODE_TYPES } from '@gadmin2n/nest-common/workflow-dsl';
 import { Prisma, PrismaClient } from '@prisma/client';
 
 type BaseNodeTypeSeed = {
@@ -87,15 +86,14 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     },
     inputSchema: { type: 'object', properties: {} },
     outputSchema: {
-      type: 'object',
-      properties: { triggeredAt: { type: 'string' } },
+      description: 'Workflow start data supplied by the schedule trigger',
     },
     outputs: [],
   },
   {
     type: 'webhook_trigger',
     category: 'TRIGGER',
-    label: '接收外部请求',
+    label: '接收外部调用',
     icon: 'ApiOutlined',
     description: '通过外部 HTTP POST 请求启动 Workflow',
     configSchema: {
@@ -162,7 +160,14 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
         query: { type: 'object' },
       },
     },
-    outputSchema: { type: 'object', properties: { body: { type: 'object' } } },
+    outputSchema: {
+      type: 'object',
+      properties: {
+        body: { type: 'object', description: 'Unmodified request body' },
+        headers: { type: 'object', description: 'Request headers' },
+        query: { type: 'object', description: 'Query parameters' },
+      },
+    },
     outputs: [],
   },
   {
@@ -170,7 +175,7 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     category: 'TRIGGER',
     label: 'Event Trigger',
     icon: 'ThunderboltOutlined',
-    description: 'Trigger workflow on an internal event (Temporal Signal)',
+    description: '收到内部业务事件（Outbox）后启动 Workflow',
     configSchema: {
       type: 'object',
       properties: {
@@ -212,7 +217,9 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
       required: [],
     },
     inputSchema: { type: 'object', properties: { data: { type: 'object' } } },
-    outputSchema: { type: 'object', properties: { data: { type: 'object' } } },
+    outputSchema: {
+      description: 'Workflow start data supplied for the manual run',
+    },
     outputs: [],
   },
 
@@ -299,12 +306,6 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     configSchema: {
       type: 'object',
       properties: {
-        operation: {
-          type: 'string',
-          enum: ['query', 'execute'],
-          description:
-            'query = read (SELECT), execute = write (INSERT/UPDATE/DELETE)',
-        },
         query: { type: 'string', description: 'SQL statement' },
         params: {
           type: 'array',
@@ -379,48 +380,6 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     },
     outputs: [],
   },
-  {
-    type: 'send_notification',
-    category: 'ACTION',
-    label: 'Send Notification',
-    icon: 'BellOutlined',
-    description: 'Send a notification via email, Slack, or webhook',
-    configSchema: {
-      type: 'object',
-      properties: {
-        channel: {
-          type: 'string',
-          enum: ['email', 'slack', 'webhook', 'dingtalk', 'wecom'],
-          description: 'Notification channel',
-        },
-        recipients: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Recipient list (emails, user IDs, or webhook URLs)',
-        },
-        subject: {
-          type: 'string',
-          description: 'Message subject (for email channel)',
-        },
-        message: {
-          type: 'string',
-          description:
-            'Notification message body (supports template variables)',
-        },
-        templateId: {
-          type: 'string',
-          description: 'Message template ID (optional, overrides message)',
-        },
-      },
-      required: ['channel', 'recipients', 'message'],
-    },
-    inputSchema: { type: 'object', properties: { data: { type: 'object' } } },
-    outputSchema: {
-      type: 'object',
-      properties: { sent: { type: 'boolean' }, messageId: { type: 'string' } },
-    },
-    outputs: [],
-  },
   {
     type: 'code',
     category: 'ACTION',
@@ -454,39 +413,6 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     outputs: [],
   },
 
-  // ─── DATA PROCESSING ───────────────────────────────────────────────────────
-  {
-    type: 'set_variable',
-    category: 'ACTION',
-    label: 'Set Variable',
-    icon: 'FormOutlined',
-    description: 'Set, transform, or rename values from the previous node',
-    configSchema: {
-      type: 'object',
-      properties: {
-        assignments: {
-          type: 'array',
-          items: {
-            type: 'object',
-            properties: {
-              name: { type: 'string' },
-              value: { type: 'string' },
-            },
-          },
-          description: 'Variable assignments (name → expression)',
-        },
-        keepOnlySet: {
-          type: 'boolean',
-          description: 'Remove all other fields, keep only assigned',
-        },
-      },
-      required: ['assignments'],
-    },
-    inputSchema: { type: 'object', properties: { data: { type: 'object' } } },
-    outputSchema: { type: 'object', properties: { data: { type: 'object' } } },
-    outputs: [],
-  },
-
   // ─── CONDITION ─────────────────────────────────────────────────────────────
   {
     type: 'if_else',
@@ -514,11 +440,6 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
           enum: ['AND', 'OR'],
           description: 'How to combine multiple conditions',
         },
-        fallbackExpression: {
-          type: 'string',
-          description:
-            'Fallback: raw expression (if conditions array is empty)',
-        },
       },
       required: [],
     },
@@ -568,7 +489,7 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
   // ─── FLOW CONTROL ──────────────────────────────────────────────────────────
   {
     type: 'for_each',
-    category: 'LOOP',
+    category: 'FLOW_CONTROL',
     label: 'For Each',
     icon: 'RetweetOutlined',
     description: 'Iterate over an array field',
@@ -583,10 +504,6 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
           type: 'number',
           description: 'Parallel concurrency (1 = sequential)',
         },
-        batchSize: {
-          type: 'number',
-          description: 'Process items in batches of this size',
-        },
         errorPolicy: {
           type: 'string',
           enum: ['stop', 'continue', 'collect'],
@@ -600,9 +517,10 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     outputSchema: {
       type: 'object',
       properties: {
-        currentItem: { type: 'object' },
-        index: { type: 'number' },
         results: { type: 'array' },
+        errors: { type: 'array' },
+        totalProcessed: { type: 'number' },
+        error: { type: 'string' },
       },
     },
     outputs: [],
@@ -610,7 +528,7 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
   {
     type: 'delay',
     category: 'FLOW_CONTROL',
-    label: 'Delay/Wait',
+    label: '定时等待',
     icon: 'HourglassOutlined',
     description:
       'Pause workflow execution for a specified duration (Temporal Timer)',
@@ -619,7 +537,7 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
       properties: {
         delayType: {
           type: 'string',
-          enum: ['fixedDuration', 'untilTime', 'untilSignal'],
+          enum: ['fixedDuration', 'untilTime'],
           description: 'Type of delay',
         },
         duration: {
@@ -630,10 +548,6 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
           type: 'string',
           description: 'Resume at ISO datetime (for untilTime)',
         },
-        signalName: {
-          type: 'string',
-          description: 'Signal name to wait for (for untilSignal)',
-        },
       },
       required: ['delayType'],
     },
@@ -669,12 +583,8 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
         },
         waitMode: {
           type: 'string',
-          enum: ['all', 'any', 'count'],
-          description: 'Wait for all, any one, or N branches to complete',
-        },
-        waitCount: {
-          type: 'number',
-          description: 'Number of branches to wait for (when waitMode=count)',
+          enum: ['all', 'any'],
+          description: 'Wait for all branches or any one branch to complete',
         },
       },
       required: ['branches'],
@@ -682,51 +592,7 @@ const INLINE_NODE_DEFINITIONS: BaseNodeTypeSeed[] = [
     inputSchema: { type: 'object', properties: { data: { type: 'object' } } },
     outputSchema: {
       type: 'object',
-      properties: { results: { type: 'array' } },
-    },
-    outputs: [],
-  },
-  {
-    type: 'error_handler',
-    category: 'FLOW_CONTROL',
-    label: 'Error Handler',
-    icon: 'WarningOutlined',
-    description: 'Catch errors from upstream nodes and execute fallback logic',
-    configSchema: {
-      type: 'object',
-      properties: {
-        errorTypes: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Error types to catch (empty = catch all)',
-        },
-        retryPolicy: {
-          type: 'string',
-          enum: ['none', 'fixed', 'exponential'],
-          description: 'Retry strategy before triggering error handler',
-        },
-        maxRetries: { type: 'number', description: 'Maximum retry attempts' },
-        retryInterval: {
-          type: 'number',
-          description: 'Initial retry interval in seconds',
-        },
-        fallbackAction: {
-          type: 'string',
-          enum: ['continue', 'stop', 'goto'],
-          description:
-            'Action after catching: continue downstream, stop workflow, or goto a specific node',
-        },
-        gotoNodeId: {
-          type: 'string',
-          description: 'Target node ID (when fallbackAction=goto)',
-        },
-      },
-      required: [],
-    },
-    inputSchema: { type: 'object', properties: { error: { type: 'object' } } },
-    outputSchema: {
-      type: 'object',
-      properties: { error: { type: 'object' }, handled: { type: 'boolean' } },
+      properties: { completedBranches: { type: 'number' } },
     },
     outputs: [],
   },
@@ -793,9 +659,12 @@ const approvalDefinition: BaseNodeTypeSeed = {
   outputSchema: {
     type: 'object',
     properties: {
+      requestId: { type: 'string' },
+      nodeId: { type: 'string' },
+      result: { type: 'string', enum: ['APPROVED', 'REJECTED'] },
+      reason: { type: 'string' },
+      decidedAt: { type: 'string' },
       approved: { type: 'boolean' },
-      approvedBy: { type: 'string' },
-      comment: { type: 'string' },
     },
   },
   outputs: [],
@@ -805,10 +674,9 @@ const approvalDefinition: BaseNodeTypeSeed = {
 const subWorkflowDefinition: BaseNodeTypeSeed = {
   type: 'sub_workflow',
   category: 'SUB_WORKFLOW',
-  label: 'Sub Workflow',
+  label: '调用 Workflow',
   icon: 'SubnodeOutlined',
-  description:
-    'Call another workflow as a sub-process (Temporal Child Workflow)',
+  description: '调用另一个 Workflow，并等待其返回结果',
   configSchema: {
     type: 'object',
     properties: {
@@ -821,21 +689,12 @@ const subWorkflowDefinition: BaseNodeTypeSeed = {
         description:
           'Bind child inputs to the previous node, Workflow data, or fixed values',
       },
-      waitForCompletion: {
-        type: 'boolean',
-        description: 'Wait for child workflow to finish (sync vs async)',
-      },
-      timeout: {
-        type: 'number',
-        description: 'Child workflow timeout in seconds',
-      },
     },
     required: ['workflowId'],
   },
   inputSchema: { type: 'object', properties: { data: { type: 'object' } } },
   outputSchema: {
-    type: 'object',
-    properties: { result: { type: 'object' }, status: { type: 'string' } },
+    description: 'Unmodified result returned by the called Workflow',
   },
   outputs: [],
 };
@@ -843,17 +702,17 @@ const subWorkflowDefinition: BaseNodeTypeSeed = {
 const HUMAN_APPROVAL_CONFIG_SCHEMA: NodeTypeSeed['configSchema'] = {
   type: 'object',
   properties: {
-    channelRef: {
+    approvalWorkflowId: {
       type: 'string',
-      title: 'Approval channel',
+      title: 'Approval Workflow',
       description:
-        'Optional reusable channel for dispatching to and receiving decisions from an external approval provider.',
+        'Optional callable Workflow that dispatches the request, waits for the external result, and returns the decision.',
     },
-    channelInputBindings: {
+    approvalWorkflowInputBindings: {
       ...PARAMETER_BINDINGS_SCHEMA,
       title: 'Approval document fields',
       description:
-        'Bind the selected approval channel inputs to input, Workflow data, or fixed values.',
+        'Bind the selected approval Workflow inputs to input, Workflow data, or fixed values.',
     },
     approverSources: {
       type: 'array',
@@ -947,15 +806,15 @@ const humanApprovalNode: NodeTypeSeed = {
   configSchema: HUMAN_APPROVAL_CONFIG_SCHEMA,
   outputs: ['true', 'false'],
   runtimeKey: 'human_approval',
-  schemaVersion: 6,
+  schemaVersion: 7,
   instancePolicy: 'REQUIRED',
   uiSchema: HUMAN_APPROVAL_UI_SCHEMA,
 };
 
 const callableTriggerNode: NodeTypeSeed = {
   type: 'callable_trigger',
-  category: 'TRIGGER',
-  label: '接收调用',
+  category: 'SUB_WORKFLOW',
+  label: '接收内部调用',
   icon: 'ImportOutlined',
   description: '接收其他地方传入的 Workflow 启动数据',
   configSchema: {
@@ -977,7 +836,9 @@ const callableTriggerNode: NodeTypeSeed = {
     },
   },
   inputSchema: { type: 'object' },
-  outputSchema: { type: 'object' },
+  outputSchema: {
+    description: 'Workflow start data supplied by the caller',
+  },
   outputs: [],
   runtimeKey: 'callable_trigger',
   schemaVersion: 2,
@@ -989,233 +850,73 @@ const callableTriggerNode: NodeTypeSeed = {
   },
 };
 
-const approvalRequestTriggerNode: NodeTypeSeed = {
-  type: 'approval_request_trigger',
-  category: 'TRIGGER',
-  label: '接收调用',
-  icon: 'AuditOutlined',
-  description: '旧版审批调用入口，仅用于兼容已有 Workflow',
-  configSchema: {
-    type: 'object',
-    properties: {},
-  },
-  inputSchema: { type: 'object' },
-  outputSchema: { type: 'object' },
-  outputs: [],
-  runtimeKey: 'approval_request_trigger',
-  schemaVersion: 1,
-  instancePolicy: 'INLINE_ONLY',
-  uiSchema: {
-    widget: 'approval-request-trigger-config',
-  },
-};
-
 const returnResultNode: NodeTypeSeed = {
   type: 'return_result',
-  category: 'ACTION',
-  label: '返回结果',
+  category: 'SUB_WORKFLOW',
+  label: '返回调用',
   icon: 'ExportOutlined',
-  description: '把上一个节点或 Workflow 数据返回给调用方',
+  description: '结束当前 Workflow，并把上一个节点的结果返回给调用方',
   configSchema: {
     type: 'object',
-    properties: {
-      resultType: {
-        type: 'string',
-        title: '结果类型',
-        enum: ['JSON', 'APPROVAL_SUBJECTS'],
-        default: 'JSON',
-      },
-      sourceMode: {
-        type: 'string',
-        title: '结果来源',
-        enum: ['INPUT', 'WORKFLOW'],
-        default: 'INPUT',
-      },
-      path: {
-        type: 'string',
-        title: 'Workflow 数据字段',
-        description: '例如 approvers',
-      },
-      httpStatusCode: {
-        type: 'integer',
-        title: 'HTTP 状态码',
-        minimum: 100,
-        maximum: 599,
-        default: 200,
-      },
-      httpHeaders: {
-        type: 'object',
-        title: 'HTTP 响应头',
-        additionalProperties: { type: 'string' },
-        default: {},
-      },
-    },
-    required: ['resultType', 'sourceMode'],
+    properties: {},
+    additionalProperties: false,
   },
   inputSchema: { type: 'object' },
   outputSchema: { type: 'object' },
   outputs: [],
   runtimeKey: 'return_result',
-  schemaVersion: 4,
+  schemaVersion: 5,
   instancePolicy: 'INLINE_ONLY',
   uiSchema: { widget: 'return-result-config' },
 };
 
-const submitApprovalResultNode: NodeTypeSeed = {
-  type: 'submit_approval_result',
-  category: 'ACTION',
-  label: '提交审批结果',
-  icon: 'CheckCircleOutlined',
-  description: '把外部系统的审批决定提交给正在等待的人工审核节点',
-  configSchema: {
-    type: 'object',
-    properties: {
-      inputBindings: {
-        type: 'object',
-        properties: Object.fromEntries(
-          [
-            'requestId',
-            'channelRef',
-            'eventId',
-            'approverId',
-            'decision',
-            'comment',
-            'payload',
-          ].map((key) => [key, PARAMETER_BINDING_SCHEMA]),
-        ),
-        required: [
-          'requestId',
-          'channelRef',
-          'eventId',
-          'approverId',
-          'decision',
-        ],
-        additionalProperties: false,
-      },
-    },
-    required: ['inputBindings'],
-    additionalProperties: false,
-  },
-  inputSchema: { description: 'Normalized approval result' },
-  outputSchema: {
-    type: 'object',
-    properties: {
-      accepted: { type: 'boolean' },
-      requestId: { type: 'string' },
-    },
-  },
-  outputs: [],
-  runtimeKey: 'submit_approval_result',
-  schemaVersion: 1,
-  instancePolicy: 'INLINE_ONLY',
-  uiSchema: { widget: 'submit-approval-result-config' },
-};
-
-const submitExternalResultNode: NodeTypeSeed = {
-  type: 'submit_external_result',
-  category: 'ACTION',
-  label: '提交外部处理结果',
-  icon: 'ApiOutlined',
-  description: '把外部系统的处理结果提交给正在等待的 Workflow',
-  configSchema: {
-    type: 'object',
-    properties: {
-      inputBindings: {
-        type: 'object',
-        properties: Object.fromEntries(
-          ['callbackToken', 'eventId', 'outcome', 'operatorId', 'data'].map(
-            (key) => [key, PARAMETER_BINDING_SCHEMA],
-          ),
-        ),
-        required: ['callbackToken', 'eventId', 'outcome'],
-        additionalProperties: false,
-      },
-    },
-    required: ['inputBindings'],
-    additionalProperties: false,
-  },
-  inputSchema: { description: 'External callback payload' },
-  outputSchema: {
-    type: 'object',
-    properties: {
-      accepted: { type: 'boolean' },
-      duplicate: { type: 'boolean' },
-      resolved: { type: 'boolean' },
-    },
-  },
-  outputs: [],
-  runtimeKey: 'submit_external_result',
-  schemaVersion: 1,
-  instancePolicy: 'INLINE_ONLY',
-  uiSchema: { widget: 'submit-external-result-config' },
-};
-
 const externalWaitNode: NodeTypeSeed = {
   type: 'external_wait',
   category: 'FLOW_CONTROL',
-  label: '等待外部处理',
+  label: '等待外部结果',
   icon: 'HourglassOutlined',
-  description: '发起外部处理，并在收到结果后从对应出口继续',
+  description: '阻塞当前 Workflow，直到收到 callbackToken 对应的外部回调',
   configSchema: {
     type: 'object',
     properties: {
-      dispatchWorkflowId: {
-        type: 'string',
-        title: '发送 Workflow',
-        pattern: '^[1-9][0-9]*$',
-      },
-      callbackWorkflowId: {
-        type: 'string',
-        title: '回调 Workflow',
-        pattern: '^[1-9][0-9]*$',
-      },
-      businessDataBinding: PARAMETER_BINDING_SCHEMA,
-      participantsBinding: PARAMETER_BINDING_SCHEMA,
-      outcomes: {
-        type: 'array',
-        minItems: 1,
-        items: {
-          type: 'object',
-          properties: {
-            code: {
-              type: 'string',
-              pattern: '^[A-Z][A-Z0-9_]{0,63}$',
-            },
-            label: { type: 'string', minLength: 1, maxLength: 64 },
-          },
-          required: ['code', 'label'],
-          additionalProperties: false,
-        },
-      },
+      callbackTokenBinding: PARAMETER_BINDING_SCHEMA,
       timeout: {
         type: 'object',
         properties: {
+          mode: {
+            type: 'string',
+            enum: ['DEADLINE', 'DURATION', 'NONE'],
+          },
           durationSeconds: { type: 'integer', minimum: 1 },
-          outcome: { type: 'string', const: 'TIMEOUT' },
+          deadlineBinding: PARAMETER_BINDING_SCHEMA,
         },
-        required: ['durationSeconds', 'outcome'],
+        required: ['mode'],
         additionalProperties: false,
       },
     },
-    required: ['dispatchWorkflowId', 'outcomes', 'timeout'],
+    required: ['callbackTokenBinding', 'timeout'],
     additionalProperties: false,
   },
   inputSchema: {
-    description: '上一个节点的结果；默认作为发送给外部系统的业务数据',
+    description: '等待外部回调所需的 callbackToken 和截止时间',
   },
   outputSchema: {
     type: 'object',
     properties: {
+      callbackToken: { type: 'string' },
+      nodeId: { type: 'string' },
+      eventId: { type: 'string' },
       outcome: { type: 'string' },
       operatorId: { type: 'string' },
       data: { type: 'object' },
       completedAt: { type: 'string' },
+      reason: { type: 'string' },
     },
-    required: ['outcome'],
+    required: ['callbackToken'],
   },
-  outputs: null,
+  outputs: ['RECEIVED', 'TIMEOUT'],
   runtimeKey: 'external_wait',
-  schemaVersion: 1,
+  schemaVersion: 2,
   instancePolicy: 'INLINE_ONLY',
   uiSchema: { widget: 'external-wait-config' },
 };
@@ -1274,10 +975,7 @@ const codeNode: NodeTypeSeed = {
   },
   inputSchema: { description: 'Any JSON value from the previous node' },
   outputSchema: {
-    type: 'object',
-    properties: {
-      result: { description: 'Any JSON value returned by the script' },
-    },
+    description: 'Any JSON value returned by the script',
   },
   runtimeKey: 'code',
   schemaVersion: 4,
@@ -1302,46 +1000,11 @@ export const NODE_TYPES: NodeTypeSeed[] = [
   codeNode,
   humanApprovalNode,
   callableTriggerNode,
-  approvalRequestTriggerNode,
   returnResultNode,
-  submitApprovalResultNode,
-  submitExternalResultNode,
   externalWaitNode,
   subWorkflowNode,
 ];
 
-// ─── Seed / nest-common consistency check ──────────────────────────────────
-//
-// Every entry in ALL_NODE_TYPES (the canonical registry in nest-common) MUST
-// have a corresponding seed row here. If a new node type is added upstream
-// but never seeded, the frontend canvas won't know how to render it — this
-// throws at seed time so the gap is caught in dev / CI, not in production.
-{
-  const seededTypes = new Set(NODE_TYPES.map((n) => n.type));
-  const missing = ALL_NODE_TYPES.filter((t) => !seededTypes.has(t));
-  if (missing.length > 0) {
-    throw new Error(
-      `[workflow-node-types seed] Missing seed rows for node types: ${missing.join(
-        ', ',
-      )}. ` +
-        `Add them to NODE_TYPES above, or (if the type was removed upstream, which nest-common ` +
-        `disallows — see workflow-dsl/README.md) coordinate a major bump.`,
-    );
-  }
-  const extra = [...seededTypes].filter(
-    (t) => !(ALL_NODE_TYPES as readonly string[]).includes(t),
-  );
-  if (extra.length > 0) {
-    // Extras are NOT an error — a downstream project may seed additional
-    // types locally. Log for visibility.
-    console.warn(
-      `[workflow-node-types seed] Extra local-only node types: ${extra.join(
-        ', ',
-      )}`,
-    );
-  }
-}
-
 export async function seedNodeTypes(prisma: PrismaClient) {
   console.log('Seeding workflow node types...');
   for (const nodeType of NODE_TYPES) {