@baasix/baasix 0.1.0

package/dist/services/WorkflowService.d.ts

@@ -0,0 +1,305 @@
+import ItemsService from "./ItemsService.js";
+/**
+ * WorkflowService - Comprehensive workflow execution engine
+ * Supports: HTTP requests, data transformation, conditions, loops, service operations
+ */
+declare class WorkflowService {
+    private initialized;
+    private scheduledJobs;
+    private customModules;
+    private stepProcessors;
+    constructor();
+    /**
+     * Register a custom module that can be used in script nodes
+     * @param moduleName - Name of the module (used in require())
+     * @param moduleExport - The module export (function, object, or class)
+     * @param options - Optional configuration
+     */
+    registerCustomModule(moduleName: string, moduleExport: any, options?: any): void;
+    /**
+     * Unregister a custom module
+     * @param moduleName - Name of the module to unregister
+     */
+    unregisterCustomModule(moduleName: string): boolean;
+    /**
+     * Get all registered custom modules
+     * @returns List of registered modules with metadata
+     */
+    getRegisteredModules(): {
+        name: any;
+        description: any;
+        allowRequire: any;
+        registeredAt: any;
+    }[];
+    /**
+     * Check if a module is available (built-in or custom)
+     * @param moduleName - Name of the module
+     * @returns boolean
+     */
+    isModuleAvailable(moduleName: string): boolean;
+    init(): Promise<void>;
+    ensureInitialized(): Promise<void>;
+    /**
+     * Create execution record (without starting execution)
+     */
+    createExecutionRecord(workflowId: string | number, userId?: any, tenantId?: any): Promise<any>;
+    /**
+     * Execute workflow asynchronously using existing execution record
+     */
+    executeWorkflowAsync(workflowId: string | number, triggerData?: any, userId?: any, tenantId?: any, executionId?: any): Promise<void>;
+    /**
+     * Execute a workflow (legacy method - creates record and executes)
+     */
+    executeWorkflow(workflowId: string | number, triggerData?: any, userId?: any, tenantId?: any): Promise<any>;
+    /**
+     * Run workflow execution
+     */
+    runWorkflowExecution(executionId: string | number, workflow: any, triggerData: any): Promise<void>;
+    /**
+     * Execute a single node and its descendants
+     */
+    executeNode(node: any, allNodes: any[], edges: any[], context: any, executionId: string | number, LogService: ItemsService): Promise<any>;
+    /**
+     * Process trigger node
+     */
+    processTriggerNode(_node: any, context: any): Promise<any>;
+    /**
+     * Process HTTP request node
+     */
+    processHttpNode(node: any, context: any): Promise<{
+        status: number;
+        statusText: string;
+        headers: {
+            [k: string]: string;
+        };
+        data: any;
+    }>;
+    /**
+     * Process transformation node
+     */
+    processTransformNode(node: any, context: any): Promise<any>;
+    /**
+     * Execute JavaScript transformation script
+     */
+    executeTransformScript(script: string, context: any): any;
+    /**
+     * Apply field mapping transformation
+     */
+    applyFieldMapping(mapping: Record<string, any>, context: any): Record<string, any>;
+    /**
+     * Process condition node
+     */
+    processConditionNode(node: any, context: any, allNodes: any[], edges: any[], executionId: string | number, LogService: ItemsService): Promise<{
+        conditionMet: boolean;
+        results: any;
+        branch: string;
+    }>;
+    /**
+     * Execute a condition branch
+     * Executes nodes until they connect back to the condition's "condition-end" handle
+     */
+    executeConditionBranch(conditionNodeId: string, startNode: any, allNodes: any[], edges: any[], context: any, executionId: string | number, LogService: ItemsService): Promise<void>;
+    /**
+     * Evaluate a single condition
+     */
+    evaluateCondition(condition: any, context: any): boolean;
+    /**
+     * Process service operation node
+     */
+    processServiceNode(node: any, context: any): Promise<any>;
+    /**
+     * Process loop node
+     */
+    processLoopNode(node: any, context: any, allNodes: any[], edges: any[], executionId: string | number, LogService: ItemsService): Promise<{
+        items: any[];
+        count: number;
+    }>;
+    /**
+     * Execute a single loop iteration
+     * Executes nodes until they connect back to the loop's "loop-end" handle
+     */
+    executeLoopIteration(loopNodeId: string, loopBodyEdges: any[], allNodes: any[], edges: any[], context: any, executionId: string | number, LogService: ItemsService): Promise<Record<string, any>>;
+    /**
+     * Execute a single node without following its edges
+     * Used by loop iteration to have finer control over execution flow
+     */
+    executeSingleNode(node: any, context: any, executionId: string | number, LogService: ItemsService, allNodes?: any[], edges?: any[]): Promise<any>;
+    /**
+     * Process filter node
+     */
+    processFilterNode(node: any, context: any): Promise<{
+        items: any[];
+        count: number;
+    }>;
+    /**
+     * Process aggregate node
+     */
+    processAggregateNode(node: any, context: any): Promise<{
+        result: any;
+    }>;
+    /**
+     * Process delay node
+     */
+    processDelayNode(node: any, context: any): Promise<{
+        delayed: any;
+    }>;
+    /**
+     * Process notification node
+     */
+    processNotificationNode(node: any, context: any): Promise<string | number>;
+    /**
+     * Replace template variables in a value (string, object, or array)
+     */
+    replaceTemplateVariables(value: any, context: any): any;
+    /**
+     * Evaluate expression to get value from context
+     */
+    evaluateExpression(expression: any, context: any, defaultData?: any): any;
+    /**
+     * Register hooks for workflow triggers
+     */
+    registerWorkflowHooks(): void;
+    /**
+     * Trigger workflows by hook event
+     * @returns Object with modifiedData if workflows modified the data, null otherwise
+     */
+    triggerWorkflowsByHook(collection: string, action: string, data: any): Promise<{
+        modifiedData: any;
+    }>;
+    /**
+     * Initialize scheduled workflows
+     */
+    initializeScheduledWorkflows(): Promise<void>;
+    /**
+     * Try to acquire distributed lock for scheduled workflow execution
+     * @param workflowId - Workflow ID
+     * @param lockTimeout - Lock timeout in seconds (default: 300 = 5 minutes)
+     * @returns True if lock acquired, false otherwise
+     */
+    tryAcquireScheduledWorkflowLock(workflowId: string | number, lockTimeout?: number): Promise<boolean>;
+    /**
+     * Release distributed lock for scheduled workflow
+     * @param workflowId - Workflow ID
+     */
+    releaseScheduledWorkflowLock(workflowId: string | number): Promise<void>;
+    /**
+     * Schedule a workflow
+     */
+    scheduleWorkflow(workflow: any): void;
+    /**
+     * Cancel a scheduled workflow
+     */
+    cancelScheduledWorkflow(workflowId: string | number): void;
+    /**
+     * Process email node - Send email using MailService
+     */
+    processEmailNode(node: any, context: any): Promise<{
+        success: boolean;
+        sent: number;
+        failed: number;
+        results: any[];
+    }>;
+    /**
+     * Process workflow node - Execute another workflow and return its result
+     */
+    processWorkflowNode(node: any, context: any): Promise<{
+        success: boolean;
+        executionId: any;
+        status: string;
+        result: any;
+        async?: undefined;
+    } | {
+        success: boolean;
+        executionId: any;
+        status: string;
+        async: boolean;
+        result?: undefined;
+    }>;
+    /**
+     * Process stats node - Generate statistics using StatsService
+     */
+    processStatsNode(node: any, context: any): Promise<{
+        success: boolean;
+        collection: any;
+        operation: any;
+        stats: any;
+    }>;
+    /**
+     * Process file node - File operations using FilesService
+     */
+    processFileNode(node: any, context: any): Promise<{
+        success: boolean;
+        operation: string;
+        file: any;
+        fileId?: undefined;
+        files?: undefined;
+        total?: undefined;
+    } | {
+        success: boolean;
+        operation: string;
+        fileId: any;
+        file?: undefined;
+        files?: undefined;
+        total?: undefined;
+    } | {
+        success: boolean;
+        operation: string;
+        files: any[];
+        total: any;
+        file?: undefined;
+        fileId?: undefined;
+    }>;
+    /**
+     * Process variable node - Set workflow variables
+     */
+    processVariableNode(node: any, context: any): Promise<{
+        success: boolean;
+        variables: Record<string, any>;
+    }>;
+    /**
+     * Process script node - Execute custom JavaScript
+     */
+    processScriptNode(node: any, context: any): Promise<{
+        success: boolean;
+        result: any;
+    }>;
+    /**
+     * Process try-catch node - Error handling
+     */
+    processTryNode(node: any, context: any, allNodes: any[], edges: any[], executionId: string | number, LogService: ItemsService): Promise<{
+        success: boolean;
+        branch: string;
+        error: any;
+    }>;
+    /**
+     * Execute a try/catch branch
+     * Executes nodes until they connect back to the try node's "try-end" handle
+     */
+    executeTryBranch(tryNodeId: string, startNode: any, allNodes: any[], edges: any[], context: any, executionId: string | number, LogService: ItemsService): Promise<void>;
+    /**
+     * Execute a single node (for testing individual steps)
+     */
+    executeSingleNodeFromAPI(workflowId: string | number, nodeId: string, inputData: any, userId: any, tenantId: any, workflowData?: any): Promise<{
+        success: boolean;
+        nodeId: string;
+        nodeType: any;
+        input: {
+            trigger: any;
+            variables: any;
+            loop: any;
+            error: any;
+        };
+        output: any;
+        workflow: any;
+    }>;
+    /**
+     * Graceful shutdown
+     */
+    shutdown(): Promise<void>;
+}
+declare global {
+    var __baasix_workflowService: WorkflowService | undefined;
+}
+declare const workflowService: WorkflowService;
+export default workflowService;
+//# sourceMappingURL=WorkflowService.d.ts.map

package/dist/services/WorkflowService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowService.d.ts","sourceRoot":"","sources":["../../baasix/services/WorkflowService.ts"],"names":[],"mappings":"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"}