@fluxo-dev/shell-workflow 26.1.1 → 26.1.2

package/src/lib/workflow/designer-v2/types/node-data.types.d.ts

@@ -0,0 +1,52 @@
+import { NodeType, NodeHandles, ActionInput } from '@fluxo-dev/api-client-base';
+/**
+ * Extended NodeData for ReactFlow nodes
+ * Includes all properties needed for UI + backend compatibility
+ */
+export interface NodeData {
+    label: string;
+    nodeType: NodeType;
+    stepType?: string;
+    inputs?: Record<string, ActionInput>;
+    outputs?: Record<string, unknown>;
+    handles: NodeHandles;
+    condition?: string;
+    collection?: string;
+    interval?: string;
+    cronExpression?: string;
+    eventName?: string;
+    eventKey?: string;
+    branches?: number;
+    [key: string]: unknown;
+}
+/**
+ * Available output from a previous node
+ */
+export interface AvailableOutput {
+    nodeId: string;
+    nodeLabel: string;
+    outputId: string;
+    outputName: string;
+    outputType: string;
+}
+/**
+ * Input definition for primitive nodes
+ */
+export interface PrimitiveInput {
+    id: string;
+    name: string;
+    description: string;
+    required: boolean;
+    dataType: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'expression';
+    defaultValue?: any;
+}
+/**
+ * Primitive workflow node definition
+ */
+export interface WorkflowPrimitive {
+    type: NodeType;
+    label: string;
+    description: string;
+    icon: string;
+    inputs?: PrimitiveInput[];
+}

package/src/lib/workflow/designer-v2/types/workflow-state.types.d.ts

@@ -0,0 +1,28 @@
+import { Node, Edge } from '@xyflow/react';
+import { NodeData } from './node-data.types';
+/**
+ * Workflow metadata
+ */
+export interface WorkflowMetadata {
+    name: string;
+    description: string;
+    category: string;
+    workflowId?: string;
+}
+/**
+ * Complete workflow state
+ */
+export interface WorkflowState {
+    nodes: Node<NodeData>[];
+    edges: Edge[];
+    selectedNodeId: string | null;
+    metadata: WorkflowMetadata;
+}
+/**
+ * Workflow save data
+ */
+export interface WorkflowSaveData {
+    nodes: Node<NodeData>[];
+    edges: Edge[];
+    metadata: WorkflowMetadata;
+}

package/src/lib/workflow/designer-v2/utils/branch-validation.d.ts

@@ -0,0 +1,43 @@
+import { Edge, Node } from '@xyflow/react';
+import { NodeData } from '../types';
+/**
+ * Validate if a new edge would create a cross-branch connection
+ *
+ * IMPORTANT: Connections TO a Join node are ALLOWED even if cross-branch,
+ * because Join is specifically designed to merge parallel branches!
+ *
+ * @param sourceNodeId - Source node ID of the new edge
+ * @param targetNodeId - Target node ID of the new edge
+ * @param existingEdges - All existing edges in the workflow
+ * @param nodes - All nodes in the workflow (to check if target is a Join)
+ * @returns Object with isValid flag and error message if invalid
+ */
+export declare const validateCrossBranchConnection: (sourceNodeId: string, targetNodeId: string, existingEdges: Edge[], nodes: Node<NodeData>[]) => {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Check if a connection would create a cycle
+ *
+ * @param sourceNodeId - Source node ID
+ * @param targetNodeId - Target node ID
+ * @param existingEdges - All existing edges
+ * @returns Object with isValid flag and error message if invalid
+ */
+export declare const validateNoCycle: (sourceNodeId: string, targetNodeId: string, existingEdges: Edge[]) => {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Validate a new connection comprehensively
+ *
+ * @param sourceNodeId - Source node ID
+ * @param targetNodeId - Target node ID
+ * @param existingEdges - All existing edges
+ * @param nodes - All nodes in the workflow
+ * @returns Object with isValid flag and error message if invalid
+ */
+export declare const validateConnection: (sourceNodeId: string, targetNodeId: string, existingEdges: Edge[], nodes: Node<NodeData>[]) => {
+    isValid: boolean;
+    error?: string;
+};

package/src/lib/workflow/designer-v2/utils/handle-helpers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get handle color based on handle ID/outcome
+ */
+export declare const getHandleColor: (handleId: string | undefined | null) => string;
+/**
+ * Check if handle is an outcome (not default)
+ */
+export declare const isOutcomeHandle: (handleId: string | undefined | null) => boolean;

package/src/lib/workflow/designer-v2/utils/icon-mapper.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+/**
+ * Map icon name (string) to React Icon component
+ */
+export declare const getIconComponent: (iconName: string, size?: number) => React.ReactNode;

package/src/lib/workflow/designer-v2/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './handle-helpers';
+export * from './validation';
+export * from './transformers';
+export * from './node-factory';
+export * from './parallel-detection';
+export * from './branch-validation';
+export * from './icon-mapper';
+export * from './while-visual-edges';

package/src/lib/workflow/designer-v2/utils/node-factory.d.ts

@@ -0,0 +1,31 @@
+import { Node } from '@xyflow/react';
+import { NodeTypeEnum, WorkflowActionDto, WorkflowTriggerDto, ActionInputTypeEnum } from '@fluxo-dev/api-client-base';
+import { NodeData } from '../types';
+/**
+ * Create a new action node
+ */
+export declare const createActionNode: (action: WorkflowActionDto) => Node<NodeData>;
+/**
+ * Create a new primitive node
+ */
+export declare const createPrimitiveNode: (primitiveType: NodeTypeEnum, label: string) => Node<NodeData>;
+/**
+ * Create trigger node (replaces Start node)
+ * Triggers are always initial nodes and can have inputs/outputs like actions
+ */
+export declare const createTriggerNode: (trigger: WorkflowTriggerDto, position?: {
+    x: number;
+    y: number;
+}, workflowId?: number) => Node<NodeData>;
+/**
+ * Create start node (DEPRECATED - use createTriggerNode instead)
+ * Kept for backward compatibility
+ */
+export declare const createStartNode: () => Node<NodeData>;
+/**
+ * Create default ActionInput with Manual type
+ */
+export declare const createDefaultActionInput: (value: any) => {
+    type: ActionInputTypeEnum;
+    value: any;
+};

package/src/lib/workflow/designer-v2/utils/parallel-detection.d.ts

@@ -0,0 +1,32 @@
+import { Edge } from '@xyflow/react';
+/**
+ * Detects parallel execution from edges
+ * A node has parallel execution if the same sourceHandle connects to multiple targets
+ */
+export interface ParallelExecution {
+    nodeId: string;
+    handle: string;
+    targetCount: number;
+    targets: string[];
+}
+/**
+ * Find all parallel executions in the workflow
+ * @param edges - All edges in the workflow
+ * @returns Array of parallel execution configurations
+ */
+export declare const detectParallelExecutions: (edges: Edge[]) => ParallelExecution[];
+/**
+ * Check if a specific node has parallel execution on any of its handles
+ * @param nodeId - The node ID to check
+ * @param edges - All edges in the workflow
+ * @returns true if the node has parallel execution
+ */
+export declare const hasParallelExecution: (nodeId: string, edges: Edge[]) => boolean;
+/**
+ * Get parallel execution info for a specific node and handle
+ * @param nodeId - The node ID
+ * @param handle - The source handle
+ * @param edges - All edges in the workflow
+ * @returns ParallelExecution info or null
+ */
+export declare const getParallelExecutionInfo: (nodeId: string, handle: string, edges: Edge[]) => ParallelExecution | null;

package/src/lib/workflow/designer-v2/utils/transformers.d.ts

@@ -0,0 +1,23 @@
+import { NodeType, WorkflowNode, WorkflowEdge } from '@fluxo-dev/api-client-base';
+import { Node, Edge } from '@xyflow/react';
+import { NodeData } from '../types';
+/**
+ * Map ReactFlow type to backend NodeType
+ */
+export declare const mapNodeTypeToBackend: (reactFlowType: string | number | undefined, nodeData: NodeData) => NodeType;
+/**
+ * Convert ReactFlow nodes to backend WorkflowNodes
+ */
+export declare const convertNodesToBackend: (nodes: Node<NodeData>[]) => WorkflowNode[];
+/**
+ * Convert ReactFlow edges to backend WorkflowEdges
+ */
+export declare const convertEdgesToBackend: (edges: Edge[], nodeIds: Set<string>) => WorkflowEdge[];
+/**
+ * Convert backend WorkflowNodes to ReactFlow nodes
+ */
+export declare const convertNodesFromBackend: (workflowNodes: WorkflowNode[]) => Node<NodeData>[];
+/**
+ * Generate a valid GUID
+ */
+export declare const generateGuid: () => string;

package/src/lib/workflow/designer-v2/utils/validation.d.ts

@@ -0,0 +1,22 @@
+import { Node, Edge } from '@xyflow/react';
+import { NodeData } from '../types';
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate that all outcomes are connected
+ */
+export declare const validateOutcomes: (nodes: Node<NodeData>[], edges: Edge[]) => ValidationResult;
+/**
+ * Clean inputs/outputs by removing undefined or null keys
+ */
+export declare const cleanRecord: (record: Record<string, any> | undefined) => Record<string, any>;
+/**
+ * Validate required inputs are provided
+ */
+export declare const validateNodeInputs: (nodeData: NodeData, inputDescriptors: Array<{
+    id: string;
+    required: boolean;
+}>) => string[];

package/src/lib/workflow/designer-v2/utils/while-visual-edges.d.ts

@@ -0,0 +1,7 @@
+import { Edge, Node } from '@xyflow/react';
+import { NodeData } from '../types';
+/**
+ * Build non-persistent visual edges to show the loop-back path of While primitives.
+ * These edges are UI-only and must not be saved to backend schema.
+ */
+export declare const computeWhileReturnVisualEdges: (nodes: Node<NodeData>[], edges: Edge[]) => Edge[];

package/src/lib/workflow/designer-v2/workflow-designer-v2.d.ts

@@ -0,0 +1,8 @@
+import '@xyflow/react/dist/style.css';
+import './workflow-designer-v2.css';
+export interface WorkflowDesignerV2Props {
+    workflowId?: number;
+    onClose: () => void;
+    onSave?: () => void;
+}
+export declare function WorkflowDesignerV2({ workflowId, onClose, onSave }: WorkflowDesignerV2Props): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/action/action-card.d.ts

@@ -1,5 +0,0 @@
-import { WorkflowAction } from "@fluxo-dev/api-client-base";
-export interface ActionCardProps {
-    action: WorkflowAction;
-}
-export declare function ActionCard(props: ActionCardProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/action/action-inputs.d.ts

@@ -1,7 +0,0 @@
-import { WorkflowAction } from "@fluxo-dev/api-client-base";
-export interface ActionInputsProps {
-    actionType: string;
-    action: WorkflowAction;
-}
-declare function ActionInputs(props: ActionInputsProps): import("react/jsx-runtime").JSX.Element;
-export default ActionInputs;

package/src/lib/designer/components/action/outputs-picker.d.ts

@@ -1,6 +0,0 @@
-import { WorkflowAction } from "@fluxo-dev/api-client-base";
-export interface OutputsPickerProps {
-    action: WorkflowAction;
-    onValuePicked: (value: string) => void;
-}
-export declare function OutputsPicker(props: OutputsPickerProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/action-chooser.d.ts

@@ -1,5 +0,0 @@
-import { ActionDefinition } from "@fluxo-dev/api-client-base";
-export interface ActionChooserProps {
-    onActionSelected: (action: ActionDefinition) => void;
-}
-export declare function ActionChooser(props: ActionChooserProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/connectors/action-button.d.ts

@@ -1,8 +0,0 @@
-export interface ActionButtonProps {
-    disableBranch: boolean;
-    parentActionId: string | 'trigger';
-    parentActionOutcome: string;
-    parallelStrategy?: 'after' | 'before' | 'in-first' | 'in-last';
-    parallelBranchId?: number;
-}
-export declare function ActionButton(props: ActionButtonProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/connectors/action-connector-vertical-fill.d.ts

@@ -1,10 +0,0 @@
-export interface IActionConnectorVerticalFillProps {
-    position: 'left' | 'right' | 'center';
-    orientation: 'start' | 'end';
-    disableButton?: boolean;
-    parentActionId: string;
-    parentActionOutcome: string;
-    parallelStrategy?: 'after' | 'before' | 'in-first' | 'in-last';
-    parallelBranchId?: number;
-}
-export declare function ActionConnectorVerticalFill(props: IActionConnectorVerticalFillProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/connectors/action-connector-vertical.d.ts

@@ -1,9 +0,0 @@
-export interface ActionConnectorVerticalProps {
-    parentActionId: string;
-    parentActionOutcome: string;
-    parallelStrategy?: 'after' | 'before' | 'in-first' | 'in-last';
-    parallelBranchId?: number;
-    disableButton?: boolean;
-    disableBranch?: boolean;
-}
-export declare function ActionConnectorVertical(props: ActionConnectorVerticalProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/connectors/action-connector.d.ts

@@ -1,7 +0,0 @@
-export interface ActionConnectorProps {
-    parentActionId: string;
-    parentActionOutcome: string;
-    parallelStrategy?: 'after' | 'before' | 'in-first' | 'in-last';
-    disableBranch?: boolean;
-}
-export declare function ActionConnector(props: ActionConnectorProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/trigger/trigger-card.d.ts

@@ -1,5 +0,0 @@
-import { WorkflowTrigger } from "@fluxo-dev/api-client-base";
-export interface TriggerCardProps {
-    trigger?: WorkflowTrigger;
-}
-export declare function TriggerCard(props: TriggerCardProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/components/trigger-chooser.d.ts

@@ -1,5 +0,0 @@
-import { TriggerDefinition } from "@fluxo-dev/api-client-base";
-export interface TriggerChooserProps {
-    onTriggerSelected: (trigger: TriggerDefinition) => void;
-}
-export declare function TriggerChooser(props: TriggerChooserProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/designer/provider/workflow-designer-provider.d.ts

@@ -1,27 +0,0 @@
-import * as React from "react";
-import { TriggerCategoryDefinition, TriggerDefinition, Workflow, WorkflowAction, WorkflowActionInput, WorkflowActionInputType } from '@fluxo-dev/api-client-base';
-import { IWorkflowDesignerManager } from "../services/workflow-manager-interface";
-import { ActionCategoryDefinition, ActionDefinition, ActionOutputDefinition } from "@fluxo-dev/api-client-base";
-export interface WorkflowDesignerContextState extends IWorkflowDesignerManager {
-    workflowDefinition: Workflow | undefined;
-    openedActionId: string | undefined;
-    setOpenedAction: (actionId: string | undefined) => void;
-    workflowActionDefinitions: ActionCategoryDefinition[];
-    workflowTriggerDefinitions: TriggerCategoryDefinition[];
-    getActionDefinition: (actionType: string) => ActionDefinition | undefined;
-    findParentActions: (action: WorkflowAction) => {
-        actionId: string;
-        actionName: string;
-        outputs: ActionOutputDefinition[];
-    }[];
-    setActionInput: (actionId: string, inputPropertyName: string, inputType: WorkflowActionInputType, value: string) => void;
-    getActionInput: (actionId: string, getActionInput: string) => WorkflowActionInput | undefined;
-    getTriggerDefinition: () => TriggerDefinition | undefined;
-}
-interface WorkflowDesignerContextProps {
-    children: any;
-    workflowDefinition: Workflow | undefined;
-}
-export declare const WorkflowDesignerCtx: React.Context<WorkflowDesignerContextState | null>;
-export declare function WorkflowDesignerProvider(props: WorkflowDesignerContextProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/src/lib/designer/services/workflow-manager-interface.d.ts

@@ -1,13 +0,0 @@
-import { Workflow, WorkflowAction, WorkflowTrigger } from "@fluxo-dev/api-client-base";
-export interface IWorkflowDesignerManager {
-    load(workflowDefinition: Workflow): void;
-    createEmptyWorkflow(id: string, name: string, description: string, version: number, trigger: WorkflowTrigger): void;
-    findActionById(actionId: string): WorkflowAction | undefined;
-    addParallelAction(parentActionId: string, parallelAction: WorkflowAction): void;
-    addAction(actionToAdd: WorkflowAction, outcome: string, parentActionId: string, parallelStrategy?: 'after' | 'before' | 'in-first' | 'in-last', parallelBranchIndex?: number): void;
-    setTrigger(trigger: WorkflowTrigger): void;
-    addFirstAction(actionToAdd: WorkflowAction): void;
-    removeAction(actionToRemoveId: string): void;
-    findParentAction(childActionId: string): WorkflowAction | undefined;
-    searchLastNextActionRecursively(action: WorkflowAction, outcome: string): WorkflowAction;
-}

package/src/lib/designer/services/workflow-manager.d.ts

@@ -1,75 +0,0 @@
-import { IWorkflowDesignerManager } from "./workflow-manager-interface";
-import { Workflow, WorkflowAction, WorkflowActionInput, WorkflowActionInputType, WorkflowTrigger } from '@fluxo-dev/api-client-base';
-export declare class WorkflowDesignerManager implements IWorkflowDesignerManager {
-    private _workflowDefinition;
-    private _mode;
-    get workflowDefinition(): Workflow | undefined;
-    constructor();
-    /**
-     * Carica un workflow
-     * @param workflowDefinition workflow da caricare
-     */
-    load(workflowDefinition: Workflow): void;
-    /**
-     * Crea un nuovo workflow vuoto
-     * @param id Id dell'assemblato
-     * @param name Nome del workflow
-     * @param description Descrizione del workflow
-     * @param version Versione del workflow
-     * @param firstAction Azione principale del workflow (Trigger)
-     */
-    createEmptyWorkflow(id: string, name: string, description: string, version: number, trigger: WorkflowTrigger): void;
-    /**
-     * Attraversa l'albero partendo dalla prima azione, salva gli ids di tutte le azioni traversate finchè non trova l'azione con l'id specificato
-     * @param startAction Azione da cui iniziare la ricerca
-     * @param targetAction Azione da cercare
-     */
-    findParentActions(startAction: WorkflowAction, targetAction: WorkflowAction): string[];
-    /**
-     * Ricerca un'azione ricorsivamente grazie al suo id all'interno dell'albero del Workflow. Cerca prima nell'azione principale e poi nelle azioni parallele e nelle nextActions
-     * @param actionId id dell'azione da cercare
-     * @param startAction
-     */
-    findActionById(actionId: string, startAction?: WorkflowAction | undefined): WorkflowAction | undefined;
-    /**
-     * Aggiunge un'azione parallela all'azione padre
-     * @param parentActionId id dell'azione padre
-     * @param parallelAction azione parallela da aggiungere
-     */
-    addParallelAction(parentActionId: string, parallelAction: WorkflowAction): void;
-    addFirstAction(actionToAdd: WorkflowAction): void;
-    setTrigger(trigger: WorkflowTrigger): void;
-    /**
-     * Aggiunge un'azione al workflow
-     * @param actionToAdd azione da aggiungere
-     * @param outcome outcome dell'azione padre
-     * @param parentActionId id dell'azione padre
-     * @param parallelStrategy eventuale strategia di inserimento dell'azione parallela
-     * @param parallelBranchIndex eventuale indice del branch parallelo in cui inserire l'azione
-     */
-    addAction(actionToAdd: WorkflowAction, outcome: string, parentActionId: string, parallelStrategy?: 'after' | 'before' | 'in-first' | 'in-last', parallelBranchIndex?: number): void;
-    /**
-     * Cerca l'ultima azione figlia partendo da un'azione padre
-     * @param action child action
-     * @param outcome
-     */
-    searchLastNextActionRecursively(action: WorkflowAction, outcome?: string): WorkflowAction;
-    /**
-     * Rimuove un'azione dal workflow
-     * @param actionToRemoveId id dell'azione da rimuovere
-     */
-    removeAction(actionToRemoveId: string): void;
-    /**
-     * Ricerca l'azione padre di un'azione
-     * @param childActionId id dell'azione figlia
-     */
-    findParentAction(childActionId: string): WorkflowAction | undefined;
-    setActionInput(actionId: string, inputPropertyName: string, inputType: WorkflowActionInputType, value: string): void;
-    getActionInput(actionId: string, inputPropertyName: string): WorkflowActionInput | undefined;
-    private findActionRecursive;
-    private removeSimpleAction;
-    private removeCustomOutcomeAction;
-    private removeParallelBranch;
-    private getActionCustomOutcomeParent;
-    private findParentActionRecursive;
-}

package/src/lib/designer/workflow-designer.d.ts

@@ -1,5 +0,0 @@
-import { Workflow } from "@fluxo-dev/api-client-base";
-export interface WorkflowDesignerProps {
-    definition: Workflow | undefined;
-}
-export declare function WorkflowDesigner(props: WorkflowDesignerProps): import("react/jsx-runtime").JSX.Element;