@flowuent-org/diagramming-core 1.0.5

package/packages/diagrams/src/lib/types/automation-node-data-types.ts

@@ -0,0 +1,295 @@
+// Automation Node Data Types
+export interface AutomationNodeFormData {
+  nodeId: string;
+  title: string;
+  type: 'start' | 'api' | 'formatting' | 'sheets' | 'end';
+  isPinned?: boolean;
+  isBlock?: boolean;
+  blocks?: Array<{
+    id: string;
+    type: string;
+    data: Record<string, unknown>;
+  }>;
+  parallelChildrenCount?: number;
+  conditions?: {
+    combinator: 'and' | 'or';
+    rules: Array<{
+      field: string;
+      operator:
+        | 'equals'
+        | 'not_equals'
+        | 'contains'
+        | 'not_contains'
+        | 'greater_than'
+        | 'less_than';
+      value: string | number | boolean;
+    }>;
+  };
+  // Execution result storage
+  executionResult?: {
+    success: boolean;
+    data: string | number | boolean | object | null;
+    timestamp: string;
+    error?: string;
+    executionTime?: number;
+  };
+}
+
+export interface AutomationStartNodeForm extends AutomationNodeFormData {
+  type: 'start';
+  triggerType: 'manual' | 'scheduled' | 'event';
+  scheduleConfig?: {
+    frequency: 'hourly' | 'daily' | 'weekly' | 'monthly';
+    time?: string;
+    cron?: string;
+    timezone?: string;
+  };
+  eventConfig?: {
+    webhookUrl?: string;
+    eventType?: string;
+    filters?: Array<{
+      key: string;
+      value: string;
+      operator: 'equals' | 'contains' | 'startsWith' | 'endsWith';
+    }>;
+  };
+  initialVariables?: Array<{
+    name: string;
+    value: string;
+    type: 'string' | 'number' | 'boolean' | 'object';
+  }>;
+  outputVariable?: string;
+}
+
+export interface AutomationApiNodeForm extends AutomationNodeFormData {
+  type: 'api';
+  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  url: string;
+  headers: Array<{
+    key: string;
+    value: string;
+    enabled: boolean;
+  }>;
+  queryParams: Array<{
+    key: string;
+    value: string;
+    enabled: boolean;
+  }>;
+  body?: string;
+  bodyType: 'json' | 'form-data' | 'x-www-form-urlencoded' | 'raw';
+  timeout: number;
+  retryCount: number;
+  retryDelay: number;
+  responseVariable: string;
+  responseDataType: 'String' | 'Object' | 'Array';
+  errorHandling?: {
+    onError: 'stop' | 'retry' | 'continue';
+    maxRetries?: number;
+    fallbackValue?: string;
+  };
+}
+
+export interface AutomationFormattingNodeForm extends AutomationNodeFormData {
+  type: 'formatting';
+  inputVariable: string;
+  formattingType: 'basic' | 'ai-powered' | 'template';
+  basicFormatting?: {
+    operations: Array<{
+      type: 'trim' | 'replace' | 'extract' | 'rename' | 'filter';
+      config: {
+        fields?: string[];
+        mappings?: Array<{ from: string; to: string }>;
+        pattern?: string;
+        replacement?: string;
+        condition?: string;
+      };
+    }>;
+  };
+  templateFormatting?: {
+    template: string;
+    variables: Array<{
+      name: string;
+      source: string;
+      type: 'string' | 'number' | 'boolean' | 'object';
+    }>;
+  };
+  aiFormatting?: {
+    apiUrl: string;
+    apiKey: string;
+    model: string;
+    instruction: string;
+    temperature: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+  };
+  outputVariable: string;
+  outputDataType: 'String' | 'Object' | 'Array';
+}
+
+export interface AutomationSheetsNodeForm extends AutomationNodeFormData {
+  type: 'sheets';
+  inputVariable: string;
+  sheetsConfig: {
+    spreadsheetId: string;
+    sheetName: string;
+    range: string;
+    credentials: {
+      type: 'service-account' | 'oauth' | 'api-key';
+      serviceAccountKey?: string;
+      oauthToken?: string;
+      apiKey?: string;
+      clientEmail?: string;
+      privateKey?: string;
+      // OAuth (GIS) configuration for frontend-only auth
+      clientId?: string;
+      scopes?: string[];
+    };
+  };
+  dataMapping: {
+    headers: Array<{
+      column: string;
+      sourceField: string;
+      dataType: 'string' | 'number' | 'date' | 'boolean';
+    }>;
+    appendMode: boolean;
+    clearSheet: boolean;
+  };
+  outputVariable: string;
+  exportOptions: {
+    emailRecipients: string[];
+    fileName: string;
+    exportFormat: 'sheets' | 'excel' | 'both';
+    includeHeaders: boolean;
+    sendEmailNotification: boolean;
+    // Email sending (optional)
+    emailSendEnabled?: boolean;
+    emailSender?: string;
+    emailSubject?: string;
+    emailMessage?: string;
+    includeSpreadsheetLink?: boolean;
+    attachExcel?: boolean;
+    // Slack sending (optional)
+    slack?: SlackOutputOptions;
+    // WhatsApp sending (optional)
+    whatsapp?: WhatsAppOutputOptions;
+  };
+  errorHandling?: {
+    onError: 'stop' | 'retry' | 'continue';
+    maxRetries?: number;
+    fallbackAction?: 'skip' | 'log' | 'notify';
+  };
+}
+
+// Slack output options for Sheets node
+export interface SlackOutputOptions {
+  enabled: boolean;
+  webhookUrl: string;
+  channel: string;
+  messageTemplate?: string;
+  includeDataMode: 'inline' | 'json' | 'attachment';
+  includeSpreadsheetLink?: boolean;
+}
+
+// WhatsApp output options for Sheets node
+export interface WhatsAppOutputOptions {
+  enabled: boolean;
+  phoneNumber: string;
+  messageTemplate?: string;
+  includeDataMode: 'json' | 'summary' | 'custom';
+  // Twilio configuration
+  twilio?: TwilioWhatsAppConfig;
+}
+
+// Twilio WhatsApp configuration
+export interface TwilioWhatsAppConfig {
+  enabled: boolean;
+  accountSid: string;
+  authToken: string;
+  fromNumber: string; // WhatsApp number from Twilio (e.g., whatsapp:+14155238886)
+  isSandbox: boolean; // true for sandbox, false for production
+  templateSid?: string; // For template messages (required for production)
+  templateVariables?: Record<string, string>; // Variables for template
+}
+
+export interface AutomationEndNodeForm extends AutomationNodeFormData {
+  type: 'end';
+  outputType: 'display' | 'store' | 'send' | 'webhook';
+  displayConfig?: {
+    format: 'table' | 'json' | 'csv' | 'chart';
+    showInConsole: boolean;
+    showInUI: boolean;
+    maxRows?: number;
+  };
+  storeConfig?: {
+    destination: 'database' | 'file' | 'cloud-storage';
+    connectionString?: string;
+    tableName?: string;
+    fileName?: string;
+    format: 'json' | 'csv' | 'xml';
+  };
+  sendConfig?: {
+    method: 'email' | 'slack' | 'webhook' | 'api';
+    recipients: string[];
+    subject?: string;
+    template?: string;
+    webhookUrl?: string;
+  };
+  webhookConfig?: {
+    url: string;
+    method: 'POST' | 'PUT';
+    headers: Array<{
+      key: string;
+      value: string;
+    }>;
+    payloadTemplate?: string;
+  };
+}
+
+export type AutomationNodeForm =
+  | AutomationStartNodeForm
+  | AutomationApiNodeForm
+  | AutomationFormattingNodeForm
+  | AutomationSheetsNodeForm
+  | AutomationEndNodeForm;
+
+// Automation Workflow Data Structure
+export interface AutomationWorkflowData {
+  id: string;
+  name: string;
+  description?: string;
+  version: string;
+  createdAt: string;
+  updatedAt: string;
+  nodes: Array<{
+    id: string;
+    type: string;
+    position: { x: number; y: number };
+    data: AutomationNodeForm;
+  }>;
+  edges: Array<{
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+    data?: Record<string, unknown>;
+  }>;
+  variables?: Array<{
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    defaultValue?: string | number | boolean | object | null;
+    description?: string;
+  }>;
+  settings?: {
+    timeout?: number;
+    retryPolicy?: {
+      maxRetries: number;
+      retryDelay: number;
+      backoffMultiplier: number;
+    };
+    logging?: {
+      level: 'debug' | 'info' | 'warn' | 'error';
+      destination: 'console' | 'file' | 'database';
+    };
+  };
+}

package/packages/diagrams/src/lib/types/available-variables.ts

@@ -0,0 +1,18 @@
+export interface AvailableVariable {
+  id: string;
+  name: string;
+  type: string;
+  sourceNodeId: string;
+  sourceNodeType: string;
+  dataType?: string;
+  value?: any;
+}
+
+export interface AvailableVariablesState {
+  variables: AvailableVariable[];
+  addVariable: (variable: AvailableVariable) => void;
+  removeVariable: (id: string) => void;
+  updateVariable: (id: string, updates: Partial<AvailableVariable>) => void;
+  getVariablesByType: (type: string) => AvailableVariable[];
+  getVariableByName: (name: string) => AvailableVariable | undefined;
+}

package/packages/diagrams/src/lib/types/card-node.ts

@@ -0,0 +1,68 @@
+import { Node } from '@xyflow/react';
+import { blockTypes } from '../organisms/Card/card.params';
+import { colorMap } from './colors';
+import { RuleGroup } from './condition-builder';
+import { NodeForm } from './workflow-node-data-types';
+
+export type NodeDirection = 'bottom' | 'right' | 'left' | 'middle' | 'top';
+export type NodeVariant =
+  | 'parallel'
+  | 'branch'
+  | 'group'
+  | 'return'
+  | 'loop'
+  | 'switch'
+  | 'try'
+  | 'catch'
+  | 'tryCatch'
+  | 'forLoop'
+  | 'emptyNode'
+  | 'entity'
+  | 'call'
+  | 'function'
+  | 'let'
+  | 'set';
+
+export interface ICardNodeData {
+  isBlock?: boolean;
+  nodeId: string;
+  blocks?: IBlock[];
+  title?: string;
+  color?: keyof typeof colorMap;
+  sideHandles?: boolean;
+  img?: string;
+  caseCount?: number;
+  falseCase?: string;
+  trueCase?: string;
+  label?: string;
+  variant?: NodeVariant;
+  branchIndex?: number | 'default';
+  parallelColIndex?: number;
+  parallelChildrenCount?: number;
+  isRoot?: boolean;
+  finalNodeId?: string;
+  type?: NodeVariant;
+  formData?: NodeForm;
+  conditions?: RuleGroup;
+  isPinned?: boolean;
+  isHidden?: boolean; // Add visibility flag for expandable functionality
+}
+
+export interface IBlock {
+  id: string;
+  color: keyof typeof colorMap;
+  title: string;
+  type?: IBlockType;
+}
+
+export type IBlockType = keyof typeof blockTypes;
+
+export type ICardNode = Node & {
+  type: 'entity' | 'workflow' | 'bendPoint';
+  draggable?: boolean;
+  width?: number;
+  height?: number;
+  parentId?: string | null;
+  subParentId?: string | null;
+  data: ICardNodeData;
+};

package/packages/diagrams/src/lib/types/collaboration-types.ts

@@ -0,0 +1,114 @@
+import { Edge, Node } from '@xyflow/react';
+
+// Base collaboration node data interface extending common properties
+export interface BaseCollaborationNodeData extends Record<string, unknown> {
+  label: string;
+  description?: string;
+  color?: string;
+  sourcePosition?: 'left' | 'right';
+  targetPosition?: 'left' | 'right';
+  resizable?: boolean;
+  infiniteResize?: boolean;
+  customRestrictions?: {
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+  };
+}
+
+// Collaboration object node data interface
+export interface CollabObjectNodeData extends BaseCollaborationNodeData {
+  variant?: 'normal' | 'multiple';
+  width?: number;
+  height?: number;
+  onResize?: (id: string, width: number, height: number) => void;
+}
+
+// Actor node data for collaboration diagrams
+export interface CollabActorNodeData extends BaseCollaborationNodeData {
+  style?: 'stickman' | 'business';
+}
+
+// Collaboration edge variants
+export type CollabEdgeVariant = 'message' | 'self-message' | 'return-message';
+
+// Collaboration edge data interface
+export interface CollabEdgeData extends Record<string, unknown> {
+  variant: CollabEdgeVariant;
+  label?: string;
+  arrowHeadSource?: 'v' | 'none';
+  arrowHeadTarget?: 'v' | 'none';
+  parallelIndex?: number;
+  parallelCount?: number;
+  labelPosition?: number;
+}
+
+// Typed nodes for collaboration diagrams
+export type CollabObjectNode = Node<CollabObjectNodeData, 'collabObject'>;
+export type CollabActorNode = Node<CollabActorNodeData, 'actor'>;
+export type CollaborationNode = CollabObjectNode | CollabActorNode;
+
+// Typed edges for collaboration diagrams
+export type CollaborationEdge = Edge<CollabEdgeData>;
+
+// Props interface for collaboration diagram flow component
+export interface CollaborationDiagramProps {
+  collabNodes: Node[];
+  collabEdges: Edge[];
+}
+
+// Additional interfaces for collaboration diagram functionality
+export interface CollabObjectSettings {
+  label: string;
+  variant: 'normal' | 'multiple';
+  color?: string;
+  resizable?: boolean;
+  infiniteResize?: boolean;
+  customRestrictions?: {
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+  };
+}
+
+export interface CollabActorSettings {
+  label: string;
+  style: 'stickman' | 'business';
+  description?: string;
+  color?: string;
+}
+
+// Layout utility types
+export interface CollabNodePosition {
+  x: number;
+  y: number;
+}
+
+export interface CollabNodeSize {
+  width: number;
+  height: number;
+}
+
+export interface CollabLayoutConfig {
+  spacing: {
+    horizontal: number;
+    vertical: number;
+  };
+  alignment: 'left' | 'center' | 'right';
+}
+
+// Utility types for collaboration diagram functions
+export interface CollabHistoryEntry {
+  nodes: CollaborationNode[];
+  edges: CollaborationEdge[];
+}
+
+export type CollabHistoryState = CollabHistoryEntry[];
+
+// Utility interfaces for collaboration-specific functionality
+export interface CollabParallelEdgeInfo {
+  parallelIndex: number;
+  parallelCount: number;
+}

package/packages/diagrams/src/lib/types/colors.ts

@@ -0,0 +1,25 @@
+export const colorMap = {
+  grey: '#f0f0f0',
+  black: '#000000',
+  blue: `#00ccc8`,
+  yellow: '#f9cc00',
+  red: '#f9aaaa',
+  green: '#e6f9e6',
+  violet: '#291acc',
+  pink: '#c500cc',
+  orange: '#ffcc80',
+  indigo: '#4858E9',
+  purple: '#800080',
+};
+
+// markerEnd dont support rgbs so keeping it hex
+export const arrowColors = {
+  blue: `#00ccc8`,
+  yellow: `#f5cc00`,
+  red: `#f53232`,
+  green: `#00cc00`,
+  violet: `#2900cc`,
+  pink: `#c500cc`,
+  indigo: `#4858E9`,
+  default: `#cc8800`,
+};

package/packages/diagrams/src/lib/types/condition-builder.ts

@@ -0,0 +1,19 @@
+
+export interface RuleValue {
+  id: number;
+  label: string;
+  type: string;
+}
+
+export interface Rule {
+  id?: number;
+  field: RuleValue;
+  operator: string;
+  value: RuleValue;
+}
+
+export interface RuleGroup {
+  id?: number;
+  combinator: 'and' | 'or';
+  rules: (Rule | RuleGroup)[];
+}

package/packages/diagrams/src/lib/types/diagram-types.ts

@@ -0,0 +1,14 @@
+export type DiagramTypes =
+  | 'workflow'
+  | 'flow'
+  | 'erd'
+  | 'sequence'
+  | 'stateMachine'
+  | 'arch'
+  | 'cloud-architecture'
+  | 'case'
+  | 'collaboration'
+  | 'systemFlow'
+  | 'automation';
+
+export default DiagramTypes;

package/packages/diagrams/src/lib/types/edge-types.ts

@@ -0,0 +1,22 @@
+import { Markers } from '../assets/markers/markers.type';
+import { CustomEdgeGenerator } from '../organisms/CustomEdge/custom-edge-generator';
+import { EdgeTypes } from '../organisms/CustomEdge/custom-edge.type';
+
+export default {
+  // sidearrow: SideArrowEdge,
+  default: CustomEdgeGenerator(EdgeTypes.Default),
+  [EdgeTypes.Source2Bend]: CustomEdgeGenerator(EdgeTypes.Source2Bend),
+  [EdgeTypes.Bend2Target]: CustomEdgeGenerator(EdgeTypes.Bend2Target),
+  [EdgeTypes.Bend2Bend]: CustomEdgeGenerator(EdgeTypes.Bend2Bend),
+  automationEdge: CustomEdgeGenerator(EdgeTypes.Default),
+  // floating: FloatingEdge,
+};
+
+export const defaultEdgeOptions = {
+  style: {
+    strokeWidth: 2,
+    stroke: '#4858E9',
+  },
+  markerStart: Markers.One,
+  markerEnd: Markers.One,
+};

package/packages/diagrams/src/lib/types/function-execution.ts

@@ -0,0 +1,35 @@
+import { FunctionSignature } from './FunctionSignature';
+import { FormElementValue } from './workflow-content-dynamic-form-type';
+import { NodeForm, CallNodeForm } from './workflow-node-data-types';
+import { Expression } from './ndoe-form-types';
+
+export type FunctionArgument = {
+  name: string;
+  value: string | Expression;
+  dataType?: string;
+};
+
+export type FunctionReturnValue = {
+  [key: string]: FormElementValue | object;
+};
+
+export interface FunctionExecutionResult {
+  success: boolean;
+  returnValue: FunctionReturnValue;
+  error?: string;
+}
+
+export interface CallFormData extends CallNodeForm {
+  // All properties are inherited from CallNodeForm
+}
+
+export interface CallFormProps {
+  formData: CallFormData;
+  handleMultipleInputChanges: (changes: Partial<CallFormData>) => void;
+}
+
+export interface CustomFunctionSelectProps {
+  options: FunctionSignature[];
+  value: string | null;
+  onChange: (funcId: string) => void;
+}

package/packages/diagrams/src/lib/types/hooks.types.ts

@@ -0,0 +1,6 @@
+import { IBlockType } from './card-node';
+
+export interface UseAddBlockReturnProps {
+  title: string | undefined | null;
+  type: IBlockType;
+}