@goplasmatic/dataflow-ui 2.1.3 → 2.1.5

package/dist/lib.d.ts

@@ -0,0 +1,14 @@
+export { WorkflowVisualizer } from './components/workflow-visualizer';
+export type { WorkflowVisualizerProps, TreeSelectionType, } from './components/workflow-visualizer';
+export { WorkflowCard, TaskRow, FunctionTypeBadge, ConditionBadge, } from './components/workflow-visualizer/cards';
+export { RulesListView, WorkflowFlowView, TreeView } from './components/workflow-visualizer/views';
+export { DebuggerControls, MessageInputPanel, MessageStatePanel, DebugInfoBubble, DebugStateBadge, IntegratedDebugToolbar, } from './components/workflow-visualizer/debug';
+export { ThemeProvider, useTheme, DebuggerProvider, useDebugger, useDebuggerOptional, } from './components/workflow-visualizer/context';
+export type { Theme } from './components/workflow-visualizer/context';
+export { useTreeNodeDebugState, useWorkflowDebugState, useWorkflowConditionDebugState, useTaskDebugState, useTaskConditionDebugState, } from './components/workflow-visualizer/hooks';
+export type { TreeNodeDebugState } from './components/workflow-visualizer/hooks';
+export { SearchInput, JsonViewer, ErrorBoundary } from './components/common';
+export type { Workflow, Task, FunctionConfig, JsonLogicValue, MapMapping, MappingItem, MapFunctionInput, ValidationRule, ValidationFunctionInput, BuiltinFunctionType, Message, ErrorInfo, Change, AuditTrail, DebugNodeState, ConditionResult, ExecutionStep, ExecutionTrace, StepResult, PlaybackState, DebuggerState, DebuggerAction, DataflowEngine, EngineFactory, DebugConfig, } from './types';
+export { isBuiltinFunction, getFunctionDisplayInfo, createEmptyMessage, cloneMessage, getMessageAtStep, getChangesAtStep, getWorkflowState, getTaskState, } from './types';
+export { WasmEngineAdapter, defaultEngineFactory } from './engines';
+//# sourceMappingURL=lib.d.ts.map

package/dist/types/debug.d.ts

@@ -0,0 +1,221 @@
+import { JsonLogicValue } from './workflow';
+/**
+ * Message structure for workflow execution
+ * Mirrors the Rust Message struct from WASM output
+ */
+export interface Message {
+    /** Unique message ID */
+    id: string;
+    /** Original payload */
+    payload: Record<string, unknown>;
+    /** Context containing data, metadata, temp_data */
+    context: {
+        data: Record<string, unknown>;
+        metadata: Record<string, unknown>;
+        temp_data: Record<string, unknown>;
+    };
+    /** List of errors that occurred during processing */
+    errors: ErrorInfo[];
+    /** Audit trail of changes made during processing */
+    audit_trail: AuditTrail[];
+}
+/**
+ * Error information captured during execution
+ */
+export interface ErrorInfo {
+    /** Error code or identifier */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Task ID where error occurred */
+    task_id?: string;
+    /** Workflow ID where error occurred */
+    workflow_id?: string;
+}
+/**
+ * Audit trail entry for tracking changes (matches Rust AuditTrail)
+ */
+export interface AuditTrail {
+    /** Workflow ID where change occurred */
+    workflow_id: string;
+    /** Task ID where change occurred */
+    task_id: string;
+    /** Timestamp of the change */
+    timestamp: string;
+    /** Changes made by the task */
+    changes: Change[];
+    /** Status code (e.g., 200 for success) */
+    status: number;
+}
+/**
+ * A single change in the audit trail
+ */
+export interface Change {
+    /** Path to the changed field (e.g., "data.user.name") */
+    path: string;
+    /** Previous value */
+    old_value: unknown;
+    /** New value */
+    new_value: unknown;
+}
+/**
+ * Result of a step (executed or skipped)
+ */
+export type StepResult = 'executed' | 'skipped';
+/**
+ * A single step in the execution trace (matches Rust ExecutionStep)
+ */
+export interface ExecutionStep {
+    /** ID of the workflow this step belongs to */
+    workflow_id: string;
+    /** ID of the task (undefined for workflow-level skips) */
+    task_id?: string;
+    /** Result of the step execution */
+    result: StepResult;
+    /** Message snapshot after this step (only for executed steps) */
+    message?: Message;
+    /** Context snapshots before each mapping (map tasks only, trace mode) */
+    mapping_contexts?: Record<string, unknown>[];
+}
+/**
+ * Complete execution trace (matches Rust ExecutionTrace)
+ */
+export interface ExecutionTrace {
+    /** All execution steps in order */
+    steps: ExecutionStep[];
+}
+/**
+ * Debug state for a node in the execution tree
+ */
+export type DebugNodeState = 'pending' | 'current' | 'executed' | 'skipped' | 'error';
+/**
+ * Result of evaluating a condition
+ */
+export interface ConditionResult {
+    /** The condition that was evaluated */
+    condition: JsonLogicValue;
+    /** The result of evaluation */
+    result: boolean;
+    /** Data context used for evaluation */
+    context: Record<string, unknown>;
+}
+/**
+ * Playback state for the debugger
+ */
+export type PlaybackState = 'stopped' | 'playing' | 'paused';
+/**
+ * Complete debugger state
+ */
+export interface DebuggerState {
+    /** Whether debug mode is active */
+    isActive: boolean;
+    /** Current execution trace */
+    trace: ExecutionTrace | null;
+    /** Current step index being viewed */
+    currentStepIndex: number;
+    /** Playback state */
+    playbackState: PlaybackState;
+    /** Playback speed (ms between steps) */
+    playbackSpeed: number;
+    /** Input payload for debugging */
+    inputPayload: Record<string, unknown> | null;
+    /** Whether the debugger is currently executing */
+    isExecuting: boolean;
+    /** Error during execution */
+    executionError: string | null;
+    /** Whether to skip steps with failed conditions (result: 'skipped') */
+    skipFailedConditions: boolean;
+}
+/**
+ * Actions for the debugger reducer
+ */
+export type DebuggerAction = {
+    type: 'ACTIVATE';
+} | {
+    type: 'DEACTIVATE';
+} | {
+    type: 'SET_INPUT_PAYLOAD';
+    payload: Record<string, unknown>;
+} | {
+    type: 'START_EXECUTION';
+} | {
+    type: 'EXECUTE_TRACE';
+    trace: ExecutionTrace;
+} | {
+    type: 'EXECUTION_ERROR';
+    error: string;
+} | {
+    type: 'PLAY';
+} | {
+    type: 'PAUSE';
+} | {
+    type: 'STOP';
+} | {
+    type: 'RESET';
+} | {
+    type: 'STEP_FORWARD';
+} | {
+    type: 'STEP_BACKWARD';
+} | {
+    type: 'GO_TO_STEP';
+    index: number;
+} | {
+    type: 'SET_SPEED';
+    speed: number;
+} | {
+    type: 'SET_SKIP_FAILED_CONDITIONS';
+    skip: boolean;
+};
+/**
+ * Create an empty message
+ */
+export declare function createEmptyMessage(): Message;
+/**
+ * Deep clone a message
+ */
+export declare function cloneMessage(message: Message): Message;
+/**
+ * Get the message at a specific step in the trace
+ * Returns the message snapshot from the last executed step at or before the given index
+ */
+export declare function getMessageAtStep(trace: ExecutionTrace, stepIndex: number): Message | null;
+/**
+ * Get the changes made at a specific step
+ * Returns the changes from the last audit_trail entry if step was executed
+ */
+export declare function getChangesAtStep(trace: ExecutionTrace, stepIndex: number): Change[];
+/**
+ * Check if a step is for a specific workflow
+ */
+export declare function isStepForWorkflow(step: ExecutionStep, workflowId: string): boolean;
+/**
+ * Check if a step is for a specific task
+ */
+export declare function isStepForTask(step: ExecutionStep, workflowId: string, taskId: string): boolean;
+/**
+ * Get the context snapshot for a specific mapping within a step.
+ * For map tasks, returns the context before that mapping executed.
+ * Falls back to the step's message context if mapping_contexts is not available.
+ */
+export declare function getMappingContext(step: ExecutionStep, mappingIndex: number): Record<string, unknown> | undefined;
+/**
+ * Get the state of a workflow based on the trace and current step
+ * Returns:
+ * - 'pending' if all workflow steps are after the current step
+ * - 'executed'/'skipped'/'error' for workflows with steps at or before current
+ * Note: Workflows don't show as 'current' - only individual tasks do
+ */
+export declare function getWorkflowState(trace: ExecutionTrace, currentStepIndex: number, workflowId: string): DebugNodeState;
+/**
+ * Get the state of a task based on the trace and current step
+ * Returns:
+ * - 'pending' for future steps (after current)
+ * - 'executed'/'skipped'/'error' for steps at or before current position
+ * Note: Tasks show as 'executed' when on their step (completed state)
+ */
+export declare function getTaskState(trace: ExecutionTrace, currentStepIndex: number, workflowId: string, taskId: string): DebugNodeState;
+/**
+ * Check if a task is the currently viewed step
+ */
+export declare function isTaskCurrent(trace: ExecutionTrace, currentStepIndex: number, workflowId: string, taskId: string): boolean;
+//# sourceMappingURL=debug.d.ts.map

package/dist/types/debug.d.ts.map

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

package/dist/types/debugConfig.d.ts

@@ -0,0 +1,38 @@
+import { EngineFactory, ExecutionTrace } from './index';
+/**
+ * Configuration for integrated debug mode in WorkflowVisualizer.
+ *
+ * When enabled, the visualizer wraps itself with a DebuggerProvider and
+ * shows integrated debug controls in the header.
+ */
+export interface DebugConfig {
+    /**
+     * Enable integrated debug mode.
+     * When true, the visualizer will include a DebuggerProvider and show debug controls.
+     */
+    enabled: boolean;
+    /**
+     * Factory function to create engine instances.
+     * Required for execution. If not provided, the run button will be disabled.
+     */
+    engineFactory?: EngineFactory;
+    /**
+     * Initial payload to use for debugging.
+     * Can also be provided via the debugPayload prop on WorkflowVisualizer.
+     */
+    initialPayload?: Record<string, unknown>;
+    /**
+     * Automatically execute when workflows or payload change.
+     * @default false
+     */
+    autoExecute?: boolean;
+    /**
+     * Callback fired when execution completes successfully.
+     */
+    onExecutionComplete?: (trace: ExecutionTrace) => void;
+    /**
+     * Callback fired when execution encounters an error.
+     */
+    onExecutionError?: (error: string) => void;
+}
+//# sourceMappingURL=debugConfig.d.ts.map

package/dist/types/debugConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugConfig.d.ts","sourceRoot":"","sources":["../../src/types/debugConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAEtD;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C"}

package/dist/types/engine.d.ts

@@ -0,0 +1,28 @@
+import { ExecutionTrace } from './debug';
+import { Workflow } from './workflow';
+/**
+ * Interface for custom dataflow engines
+ *
+ * Implement this interface to provide a custom WASM engine for executing
+ * workflows with custom functions or plugins.
+ */
+export interface DataflowEngine {
+    /**
+     * Process a payload through the engine and return an execution trace
+     * for step-by-step debugging.
+     */
+    processWithTrace(payload: Record<string, unknown>): Promise<ExecutionTrace>;
+    /**
+     * Optional cleanup method called when the engine is no longer needed.
+     * Use this to free WASM memory.
+     */
+    dispose?(): void;
+}
+/**
+ * Factory function type for creating engine instances.
+ *
+ * Called when workflows change to create a new engine instance
+ * configured with the current workflows.
+ */
+export type EngineFactory = (workflows: Workflow[]) => DataflowEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/types/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/types/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE5E;;;OAGG;IACH,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,cAAc,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './workflow';
+export * from './debug';
+export * from './engine';
+export * from './debugConfig';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/types/workflow.d.ts

@@ -0,0 +1,107 @@
+import { LucideIcon } from 'lucide-react';
+/**
+ * JSONLogic value type - can be any valid JSON value or JSONLogic expression
+ */
+export type JsonLogicValue = string | number | boolean | null | JsonLogicValue[] | {
+    [key: string]: JsonLogicValue;
+};
+/**
+ * Function configuration for a task
+ */
+export interface FunctionConfig {
+    /** Function name (e.g., "map", "validation", or custom) */
+    name: string;
+    /** Function-specific input configuration */
+    input?: Record<string, unknown>;
+}
+/**
+ * Task definition within a workflow
+ */
+export interface Task {
+    /** Unique identifier for the task */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** JSONLogic condition (evaluated against full context: data, metadata, temp_data) */
+    condition?: JsonLogicValue;
+    /** Function to execute */
+    function: FunctionConfig;
+    /** Whether to continue workflow if this task fails */
+    continue_on_error?: boolean;
+}
+/**
+ * Workflow definition
+ */
+export interface Workflow {
+    /** Unique identifier for the workflow */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Execution priority (lower = higher priority, 0 is highest) */
+    priority?: number;
+    /** Optional description */
+    description?: string;
+    /** Optional folder path for grouping (e.g., "orders/processing") */
+    path?: string;
+    /** JSONLogic condition (evaluated against full context: data, metadata, temp_data) */
+    condition?: JsonLogicValue;
+    /** Tasks in this workflow */
+    tasks: Task[];
+    /** Whether to continue processing other workflows if this one fails */
+    continue_on_error?: boolean;
+}
+/**
+ * Map function mapping configuration
+ */
+export interface MapMapping {
+    /** Target path for the mapped value */
+    path: string;
+    /** JSONLogic expression to compute the value */
+    logic: JsonLogicValue;
+}
+/**
+ * Alias for MapMapping - used in tree and details views
+ */
+export type MappingItem = MapMapping;
+/**
+ * Map function input configuration
+ */
+export interface MapFunctionInput {
+    mappings: MapMapping[];
+}
+/**
+ * Validation rule configuration
+ */
+export interface ValidationRule {
+    /** JSONLogic expression that should return true for valid data */
+    logic: JsonLogicValue;
+    /** Error message if validation fails */
+    message: string;
+    /** Optional path for the validation target */
+    path?: string;
+}
+/**
+ * Validation function input configuration
+ */
+export interface ValidationFunctionInput {
+    rules: ValidationRule[];
+}
+/**
+ * Built-in function types
+ */
+export type BuiltinFunctionType = 'map' | 'validation' | 'validate';
+/**
+ * Check if a function is a built-in type
+ */
+export declare function isBuiltinFunction(name: string): name is BuiltinFunctionType;
+/**
+ * Get display info for a function type including the Lucide icon component
+ */
+export declare function getFunctionDisplayInfo(name: string): {
+    label: string;
+    colorClass: string;
+    Icon: LucideIcon;
+};
+//# sourceMappingURL=workflow.d.ts.map

package/dist/types/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,cAAc,EAAE,GAChB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAE,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,6BAA6B;IAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,KAAK,EAAE,cAAc,CAAC;IACtB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,YAAY,GAAG,UAAU,CAAC;AAEpE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,mBAAmB,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB,CAUA"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@goplasmatic/dataflow-ui",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "type": "module",
   "description": "React visualization library for dataflow-rs workflow engine",
   "author": "Plasmatic Engineering <shankar@goplasmatic.io>",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/lib.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/lib.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },