@fluxo-dev/api-client-base 25.4.3 → 26.1.2

package/src/lib/workflow/models/etl.models.d.ts

@@ -0,0 +1,285 @@
+export interface BlockDescriptor {
+    type: string;
+    pattern: string;
+    description: string;
+    tier: number;
+    ui: BlockUiDescriptor;
+    inputs: BlockPortDescriptor[];
+    outputs: BlockPortDescriptor[];
+    configFields: BlockConfigField[];
+    dynamicInputs?: DynamicPortsDescriptor;
+    dynamicOutputs?: DynamicPortsDescriptor;
+}
+export interface BlockUiDescriptor {
+    label: string;
+    category: string;
+    icon: string;
+    color: string;
+    headerColor: string;
+}
+export interface BlockPortDescriptor {
+    id: string;
+    label: string;
+    color: string;
+    isAlwaysVisible: boolean;
+    dataType?: string;
+    conditionalVisibility?: PortVisibilityCondition[];
+}
+export interface PortVisibilityCondition {
+    configField: string;
+    value: string;
+}
+export interface BlockConfigField {
+    key: string;
+    label: string;
+    fieldType: BlockConfigFieldType;
+    required: boolean;
+    defaultValue?: any;
+    placeholder?: string;
+    description?: string;
+    options?: SelectOption[];
+    visibleWhen?: string;
+    validation?: FieldValidation;
+}
+export declare enum BlockConfigFieldType {
+    Text = 0,
+    TextArea = 1,
+    Number = 2,
+    Boolean = 3,
+    Select = 4,
+    Expression = 5,
+    Secret = 6,
+    KeyValue = 7,
+    ObjectMap = 8,
+    Json = 9,
+    JsonArray = 10,
+    ConnectionString = 11
+}
+export interface SelectOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface FieldValidation {
+    min?: number;
+    max?: number;
+    pattern?: string;
+    message?: string;
+}
+export interface BlocksByCategory {
+    [category: string]: BlockDescriptor[];
+}
+export declare enum DynamicPortType {
+    Count = 0,
+    ArrayProperty = 1
+}
+export interface DynamicPortsDescriptor {
+    type: DynamicPortType;
+    sourceField: string;
+    portNamePattern: string;
+    labelPattern: string;
+    minCount?: number;
+    maxCount?: number;
+    channelProperty?: string;
+    defaultColor?: string;
+}
+export interface PipelineDefinition {
+    $schema?: string;
+    id?: string;
+    name: string;
+    description?: string;
+    version?: string;
+    settings?: PipelineSettings;
+    variables?: Record<string, unknown>;
+    nodes: NodeDefinition[];
+    edges: EdgeDefinition[];
+}
+export interface PipelineSettings {
+    maxDegreeOfParallelism?: number;
+    boundedCapacity?: number;
+    cancellationTimeoutSeconds?: number;
+}
+export interface NodeDefinition {
+    id: string;
+    type: string;
+    pattern?: string;
+    label?: string;
+    config: Record<string, unknown>;
+    position?: {
+        x: number;
+        y: number;
+    };
+}
+export interface EdgeDefinition {
+    id?: string;
+    from: string;
+    to: string;
+    channel?: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+}
+export interface ValidationResult {
+    isValid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+export interface ValidationError {
+    code: string;
+    message: string;
+    nodeId?: string;
+    fieldKey?: string;
+    nodeIds?: string[];
+    severity: 'Error' | 'Warning';
+}
+export interface PipelineResult {
+    executionId: string;
+    status: PipelineStatus | number;
+    duration: string;
+    totalItemsProcessed: number;
+    totalItemsDeadLettered: number;
+    totalItemsSkipped: number;
+    startTime: string;
+    endTime: string;
+    blockMetrics: BlockMetrics[];
+    errorMessage?: string;
+}
+export declare enum PipelineStatus {
+    Pending = 0,
+    Running = 1,
+    Paused = 2,
+    Completed = 3,
+    Failed = 4,
+    Cancelled = 5
+}
+export declare enum NodeExecutionState {
+    Pending = 0,
+    Running = 1,
+    Completed = 2,
+    Failed = 3,
+    Cancelled = 4
+}
+export interface BlockMetrics {
+    nodeId: string;
+    nodeType: string;
+    itemsIn: number;
+    itemsOut: number;
+    itemsOutByChannel: Record<string, number>;
+    itemsDeadLettered: number;
+    itemsSkipped: number;
+    totalDuration: string;
+    throughput: number;
+    averageItemDuration: string;
+    minItemDuration: string;
+    maxItemDuration: string;
+    nodeState: NodeExecutionState | number | string;
+    hasFailed: boolean;
+    failureReason?: string;
+    previewItemsByChannel?: Record<string, PreviewItem[]>;
+}
+export interface PreviewItem {
+    [key: string]: any;
+    _truncated?: boolean;
+    _originalSize?: number;
+}
+export interface SavePipelineRequest {
+    id?: string;
+    name: string;
+    description?: string;
+    category?: string;
+    definitionJson: string;
+    isActive: boolean;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface SavePipelineResponse {
+    id: string;
+    name: string;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PipelineListItem {
+    id: string;
+    name: string;
+    description?: string;
+    version: number;
+    category?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    lastExecutedAt?: string;
+    lastExecutionStatus?: PipelineStatus;
+    executionCount: number;
+    successRate: number;
+    tags?: string[];
+}
+export interface PipelineDetails {
+    id: string;
+    name: string;
+    description?: string;
+    version: number;
+    definitionJson: string;
+    category?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+    updatedBy?: string;
+    lastExecutedAt?: string;
+    lastExecutionStatus?: PipelineStatus;
+    executionCount: number;
+    successCount: number;
+    failureCount: number;
+    successRate: number;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface ExecuteSavedPipelineRequest {
+    pipelineId: string;
+    dryRun?: boolean;
+    variableOverrides?: Record<string, unknown>;
+}
+export interface PipelineExecutionHistoryItem {
+    id: string;
+    executionId: string;
+    pipelineId: string;
+    pipelineName: string;
+    pipelineVersion: string;
+    status: PipelineStatus;
+    startTime: string;
+    endTime?: string;
+    formattedDuration?: string;
+    totalItemsProcessed: number;
+    totalItemsDeadLettered: number;
+    totalItemsSkipped: number;
+    successRate: number;
+    errorMessage?: string;
+    executedBy?: string;
+    isDryRun: boolean;
+    serverHostname?: string;
+}
+export interface PipelineExecutionDetails extends PipelineExecutionHistoryItem {
+    errorStackTrace?: string;
+    blockMetricsJson?: string;
+    pipelineDefinitionSnapshot?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RunningExecutionItem {
+    executionId: string;
+    startTime: string;
+    elapsedTime: string;
+}
+export interface StopExecutionResponse {
+    success: boolean;
+    message: string;
+}
+export interface ValidatePipelineRequest {
+    definitionJson: string;
+}
+export interface ExecutePipelineRequest {
+    executionId: string;
+    definitionJson: string;
+    dryRun?: boolean;
+    isDebugMode?: boolean;
+    maxPreviewItems?: number;
+}

package/src/lib/workflow/models/index.d.ts

@@ -1,11 +1,330 @@
-export * from './action-definition';
-export * from './action-input-definition';
-export * from './action-output-definition';
-export * from './action-category-definition';
-export * from './workflow-action';
-export * from './workflow';
-export * from "./workflow-action-input";
-export * from "./workflow-action-input-type";
-export * from './trigger-definition';
-export * from './trigger-category-definition';
-export * from './workflow-trigger';
+export * from './etl.models';
+export interface WorkflowReactFlowSchema {
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+    metadata: WorkflowMetadata;
+}
+export interface WorkflowNode {
+    id: string;
+    type: NodeType;
+    position: NodePosition;
+    data: NodeData;
+}
+export type NodeType = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+export declare enum NodeTypeEnum {
+    Action = 0,
+    Parallel = 1,
+    Join = 2,
+    While = 3,
+    ForEach = 4,
+    Schedule = 5,
+    Delay = 6,
+    WaitForEvent = 7,
+    Decision = 8,
+    Start = 9,
+    End = 10
+}
+export interface NodePosition {
+    x: number;
+    y: number;
+}
+export interface NodeData {
+    label: string;
+    stepType?: string;
+    inputs?: Record<string, ActionInput>;
+    outputs?: Record<string, string>;
+    handles: NodeHandles;
+    condition?: string;
+    collection?: string;
+    interval?: string;
+    eventName?: string;
+    eventKey?: string;
+    branches?: number;
+}
+export interface NodeHandles {
+    source: string[];
+    target: string[];
+}
+export interface ActionInput {
+    type: ActionInputType;
+    value: any;
+}
+export type ActionInputType = 0 | 1 | 2 | 3;
+export declare enum ActionInputTypeEnum {
+    Manual = 0,// Valore statico inserito dall'utente
+    Expression = 1,// Espressione dinamica (es. "data.Counter + 1")
+    StepOutput = 2,// Output di step precedente (es. "step0.EmailSentCount")
+    Environment = 3
+}
+export interface WorkflowEdge {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+    label?: string;
+    animated?: boolean;
+}
+export interface WorkflowMetadata {
+    workflowId: string;
+    version: number;
+    description?: string;
+    dataType?: string;
+    triggerId?: string;
+    triggerInputs?: Record<string, any>;
+}
+export interface WorkflowDto {
+    id: number;
+    workflowId: string;
+    name: string;
+    description: string;
+    version: number;
+    reactFlowSchema: WorkflowReactFlowSchema;
+    workflowCoreJson: string;
+    triggerId?: string;
+    triggerInputs?: Record<string, any>;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+    tags: string[];
+    category?: string;
+}
+export interface WorkflowSummaryDto {
+    id: number;
+    workflowId: string;
+    name: string;
+    description: string;
+    version: number;
+    isActive: boolean;
+    category?: string;
+    tags: string[];
+    updatedAt: string;
+    updatedBy: string;
+}
+export interface CreateWorkflowRequest {
+    workflowId?: string;
+    name: string;
+    description?: string;
+    reactFlowSchema: WorkflowReactFlowSchema;
+    triggerId?: string;
+    triggerInputs?: Record<string, any>;
+    category?: string;
+    tags?: string[];
+    createdBy: string;
+}
+export interface UpdateWorkflowRequest {
+    name?: string;
+    description?: string;
+    reactFlowSchema?: WorkflowReactFlowSchema;
+    triggerId?: string;
+    triggerInputs?: Record<string, any>;
+    category?: string;
+    tags?: string[];
+    updatedBy: string;
+}
+export interface CloneWorkflowRequest {
+    newWorkflowId?: string;
+    newName?: string;
+    createdBy: string;
+}
+export interface WorkflowValidationResult {
+    isValid: boolean;
+    errors: WorkflowValidationError[];
+    warnings: WorkflowValidationWarning[];
+}
+export interface WorkflowValidationError {
+    code: string;
+    message: string;
+    nodeId?: string;
+    field?: string;
+}
+export interface WorkflowValidationWarning {
+    code: string;
+    message: string;
+    nodeId?: string;
+}
+export interface WorkflowActionCategoryDto {
+    name: string;
+    actions: WorkflowActionDto[];
+}
+export interface WorkflowActionDto {
+    id: string;
+    category: string;
+    name: string;
+    type: string;
+    inputs: ActionInputDescriptor[];
+    outputs: ActionOutputDescriptor[];
+    outcomes?: string[];
+    description?: string;
+    icon?: string;
+    color?: string;
+    tags?: string[];
+    groups?: InputGroup[];
+}
+export interface ActionInputDescriptor {
+    id: string;
+    name: string;
+    description?: string;
+    type: string;
+    required: boolean;
+    defaultValue?: any;
+    hasOptionsProvider: boolean;
+    uiHint: string;
+    helpText?: string;
+    placeholder?: string;
+    group?: string;
+    order: number;
+    validation?: InputValidation;
+    dependencies?: InputDependency[];
+}
+export interface ActionOutputDescriptor {
+    id: string;
+    name: string;
+    description?: string;
+    type: string;
+    displayName?: string;
+}
+/**
+ * Input group for organizing inputs in sections
+ */
+export interface InputGroup {
+    id: string;
+    displayName: string;
+    order: number;
+    collapsed: boolean;
+    description?: string;
+}
+/**
+ * Input validation rules
+ */
+export interface InputValidation {
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    pattern?: string;
+    message?: string;
+}
+/**
+ * Input dependency for conditional visibility/enabled/required
+ */
+export interface InputDependency {
+    dependsOn: string;
+    operator: DependencyOperator;
+    value?: any;
+    action: DependencyAction;
+}
+/**
+ * Dependency operators for condition evaluation
+ */
+export type DependencyOperator = 'equals' | 'notEquals' | 'in' | 'notIn' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'isNotEmpty' | 'isEmpty';
+/**
+ * Dependency actions (what happens when condition is true)
+ */
+export type DependencyAction = 'visible' | 'enabled' | 'required';
+export interface ActionInputOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface WorkflowTriggerCategoryDto {
+    name: string;
+    triggers: WorkflowTriggerDto[];
+}
+export interface WorkflowTriggerDto {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    icon?: string;
+    inputs: ActionInputDescriptor[];
+    outputs: ActionOutputDescriptor[];
+}
+export interface ConvertToWorkflowCoreResponse {
+    workflowCoreJson: string;
+}
+export interface ConvertToReactFlowRequest {
+    workflowCoreJson: string;
+    autoLayout?: boolean;
+}
+export interface Workflow {
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+}
+export interface ActionCategoryDefinition {
+    name: string;
+    actions: WorkflowActionDto[];
+}
+export interface TriggerCategoryDefinition {
+    name: string;
+    triggers: WorkflowTriggerDto[];
+}
+export declare enum WorkflowStatus {
+    Runnable = 0,// In esecuzione o pronta per eseguire
+    Suspended = 1,// Sospesa manualmente
+    Complete = 2,// Completata con successo
+    Terminated = 3
+}
+export declare enum PointerStatus {
+    Legacy = 0,
+    Pending = 1,
+    Running = 2,
+    Complete = 3,
+    Sleeping = 4,
+    WaitingForEvent = 5,
+    Failed = 6,
+    Compensated = 7,
+    Cancelled = 8
+}
+export interface WorkflowExecutionSummaryDto {
+    instanceId: string;
+    workflowDefinitionId: string;
+    version: number;
+    description: string;
+    reference: string;
+    status: WorkflowStatus;
+    createTime: string;
+    completeTime?: string;
+    nextExecution?: string;
+}
+export interface WorkflowExecutionDetailsDto {
+    instanceId: string;
+    workflowDefinitionId: string;
+    version: number;
+    description: string;
+    reference: string;
+    status: WorkflowStatus;
+    createTime: string;
+    completeTime?: string;
+    nextExecution?: string;
+    data: string;
+    steps: WorkflowExecutionStepDto[];
+    errors: WorkflowExecutionErrorDto[];
+}
+export interface WorkflowExecutionStepDto {
+    id: string;
+    stepId: number;
+    stepName: string;
+    active: boolean;
+    startTime?: string;
+    endTime?: string;
+    status: PointerStatus;
+    outcome: string;
+    retryCount: number;
+    sleepUntil?: string;
+    eventName?: string;
+    eventKey?: string;
+    eventPublished: boolean;
+    persistenceData?: string;
+    contextItem?: string;
+    predecessorId?: string;
+    scope?: string;
+}
+export interface WorkflowExecutionErrorDto {
+    workflowId: string;
+    executionPointerId: string;
+    errorTime: string;
+    message: string;
+}