@gravito/flux 3.0.1 → 3.0.2

package/dist/chunk-6AZNHVEO.cjs

@@ -0,0 +1,316 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/visualization/MermaidGenerator.ts
+var MermaidGenerator = class {
+  /**
+   * Generates a Mermaid flowchart from a workflow definition.
+   *
+   * @param definition - The workflow definition to visualize
+   * @param options - Customization options
+   * @returns Mermaid diagram syntax as a string
+   *
+   * @example
+   * ```typescript
+   * const generator = new MermaidGenerator()
+   * const diagram = generator.generateFromDefinition(workflow, {
+   *   showDetails: true,
+   *   showParallelGroups: true
+   * })
+   * console.log(diagram)
+   * ```
+   */
+  generateFromDefinition(definition, options = {}) {
+    const { showDetails = false, showParallelGroups = true, theme = "default" } = options;
+    const lines = [];
+    lines.push(`%%{init: {'theme':'${theme}'}}%%`);
+    lines.push("flowchart TD");
+    lines.push(`  Start([Start: ${definition.name}])`);
+    let prevNode = "Start";
+    const parallelGroups = /* @__PURE__ */ new Map();
+    if (showParallelGroups) {
+      for (const step of definition.steps) {
+        if (step.parallelGroup) {
+          const group = parallelGroups.get(step.parallelGroup) || [];
+          group.push(step.name);
+          parallelGroups.set(step.parallelGroup, group);
+        }
+      }
+    }
+    const processedGroups = /* @__PURE__ */ new Set();
+    for (let i = 0; i < definition.steps.length; i++) {
+      const step = definition.steps[i];
+      if (step.parallelGroup && showParallelGroups) {
+        if (processedGroups.has(step.parallelGroup)) {
+          continue;
+        }
+        processedGroups.add(step.parallelGroup);
+        const groupSteps = parallelGroups.get(step.parallelGroup);
+        const groupName = `ParallelGroup_${step.parallelGroup}`;
+        lines.push(`  subgraph ${groupName}[" "]`);
+        lines.push(`    direction LR`);
+        for (const stepName of groupSteps) {
+          const s = definition.steps.find((st) => st.name === stepName);
+          const nodeId = this.sanitizeNodeId(stepName);
+          const label = this.buildStepLabel(s, showDetails);
+          const shape = s.commit ? `[${label}]` : `(${label})`;
+          lines.push(`    ${nodeId}${shape}`);
+          if (s.compensate) {
+            lines.push(`    ${nodeId}_comp[\u{1F504} Compensate]`);
+            lines.push(`    ${nodeId} -.->|on failure| ${nodeId}_comp`);
+          }
+        }
+        lines.push(`  end`);
+        lines.push(`  ${prevNode} --> ${groupName}`);
+        prevNode = groupName;
+      } else if (!step.parallelGroup) {
+        const nodeId = this.sanitizeNodeId(step.name);
+        const label = this.buildStepLabel(step, showDetails);
+        const shape = step.commit ? `[${label}]` : `(${label})`;
+        lines.push(`  ${nodeId}${shape}`);
+        if (step.when) {
+          const condId = `${nodeId}_cond`;
+          lines.push(`  ${condId}{Condition?}`);
+          lines.push(`  ${prevNode} --> ${condId}`);
+          lines.push(`  ${condId} -->|yes| ${nodeId}`);
+          lines.push(`  ${condId} -->|no| ${this.getNextNodeId(definition.steps, i)}`);
+          prevNode = nodeId;
+        } else {
+          lines.push(`  ${prevNode} --> ${nodeId}`);
+          prevNode = nodeId;
+        }
+        if (step.compensate) {
+          lines.push(`  ${nodeId}_comp[\u{1F504} Compensate]`);
+          lines.push(`  ${nodeId} -.->|on failure| ${nodeId}_comp`);
+        }
+      }
+    }
+    lines.push(`  ${prevNode} --> End([End])`);
+    lines.push("");
+    lines.push("  classDef commitStep fill:#e1f5e1,stroke:#4caf50,stroke-width:2px");
+    lines.push("  classDef normalStep fill:#e3f2fd,stroke:#2196f3,stroke-width:2px");
+    lines.push(
+      "  classDef compensateStep fill:#fff3e0,stroke:#ff9800,stroke-width:1px,stroke-dasharray: 5 5"
+    );
+    return lines.join("\n");
+  }
+  /**
+   * Generates a Mermaid flowchart from a workflow execution state.
+   * Overlays execution status (completed, failed, compensated) on top of the structure.
+   *
+   * @param definition - The workflow definition
+   * @param state - The current execution state
+   * @param options - Customization options
+   * @returns Mermaid diagram syntax with status overlay
+   *
+   * @example
+   * ```typescript
+   * const diagram = generator.generateFromState(workflow, executionState, {
+   *   showStatus: true,
+   *   showDetails: true
+   * })
+   * ```
+   */
+  generateFromState(definition, state, options = {}) {
+    const {
+      showDetails = true,
+      showStatus = true,
+      showParallelGroups = true,
+      theme = "default"
+    } = options;
+    const lines = [];
+    lines.push(`%%{init: {'theme':'${theme}'}}%%`);
+    lines.push("flowchart TD");
+    lines.push(`  Start([Start: ${definition.name}])`);
+    lines.push(`  Start:::started`);
+    let prevNode = "Start";
+    const parallelGroups = /* @__PURE__ */ new Map();
+    const executionMap = /* @__PURE__ */ new Map();
+    for (const exec of state.history) {
+      executionMap.set(exec.name, exec);
+    }
+    if (showParallelGroups) {
+      for (const step of definition.steps) {
+        if (step.parallelGroup) {
+          const group = parallelGroups.get(step.parallelGroup) || [];
+          group.push(step.name);
+          parallelGroups.set(step.parallelGroup, group);
+        }
+      }
+    }
+    const processedGroups = /* @__PURE__ */ new Set();
+    for (let i = 0; i < definition.steps.length; i++) {
+      const step = definition.steps[i];
+      if (step.parallelGroup && showParallelGroups) {
+        if (processedGroups.has(step.parallelGroup)) {
+          continue;
+        }
+        processedGroups.add(step.parallelGroup);
+        const groupSteps = parallelGroups.get(step.parallelGroup);
+        const groupName = `ParallelGroup_${step.parallelGroup}`;
+        lines.push(`  subgraph ${groupName}[" "]`);
+        lines.push(`    direction LR`);
+        for (const stepName of groupSteps) {
+          const s = definition.steps.find((st) => st.name === stepName);
+          const nodeId = this.sanitizeNodeId(stepName);
+          const exec = executionMap.get(stepName);
+          const label = this.buildStepLabelWithStatus(s, exec, showDetails, showStatus);
+          const shape = s.commit ? `[${label}]` : `(${label})`;
+          lines.push(`    ${nodeId}${shape}`);
+          if (exec && showStatus) {
+            const statusClass = this.getStatusClass(exec.status);
+            lines.push(`    ${nodeId}:::${statusClass}`);
+          }
+          if (s.compensate && _optionalChain([exec, 'optionalAccess', _ => _.status]) === "compensated") {
+            lines.push(`    ${nodeId}_comp[\u{1F504} Compensated]`);
+            lines.push(`    ${nodeId}_comp:::compensated`);
+            lines.push(`    ${nodeId} -.->|rolled back| ${nodeId}_comp`);
+          }
+        }
+        lines.push(`  end`);
+        lines.push(`  ${prevNode} --> ${groupName}`);
+        prevNode = groupName;
+      } else if (!step.parallelGroup) {
+        const nodeId = this.sanitizeNodeId(step.name);
+        const exec = executionMap.get(step.name);
+        const label = this.buildStepLabelWithStatus(step, exec, showDetails, showStatus);
+        const shape = step.commit ? `[${label}]` : `(${label})`;
+        lines.push(`  ${nodeId}${shape}`);
+        if (exec && showStatus) {
+          const statusClass = this.getStatusClass(exec.status);
+          lines.push(`  ${nodeId}:::${statusClass}`);
+        }
+        if (step.when) {
+          const condId = `${nodeId}_cond`;
+          const skipped = _optionalChain([exec, 'optionalAccess', _2 => _2.status]) === "skipped";
+          lines.push(`  ${condId}{Condition?}`);
+          lines.push(`  ${prevNode} --> ${condId}`);
+          if (skipped) {
+            lines.push(`  ${condId}:::skipped`);
+            lines.push(`  ${condId} -->|no| ${nodeId}`);
+          } else {
+            lines.push(`  ${condId} -->|yes| ${nodeId}`);
+          }
+        } else {
+          lines.push(`  ${prevNode} --> ${nodeId}`);
+        }
+        if (step.compensate && _optionalChain([exec, 'optionalAccess', _3 => _3.status]) === "compensated") {
+          lines.push(`  ${nodeId}_comp[\u{1F504} Compensated]`);
+          lines.push(`  ${nodeId}_comp:::compensated`);
+          lines.push(`  ${nodeId} -.->|rolled back| ${nodeId}_comp`);
+        }
+        prevNode = nodeId;
+      }
+    }
+    const finalStatus = this.getWorkflowFinalStatus(state.status);
+    lines.push(`  ${prevNode} --> End([End: ${finalStatus}])`);
+    lines.push(`  End:::${this.getStatusClass(state.status)}`);
+    lines.push("");
+    lines.push("  classDef started fill:#e3f2fd,stroke:#2196f3,stroke-width:2px");
+    lines.push("  classDef completed fill:#e8f5e9,stroke:#4caf50,stroke-width:2px");
+    lines.push("  classDef failed fill:#ffebee,stroke:#f44336,stroke-width:2px");
+    lines.push("  classDef compensated fill:#fff3e0,stroke:#ff9800,stroke-width:2px");
+    lines.push(
+      "  classDef skipped fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px,stroke-dasharray: 5 5"
+    );
+    lines.push("  classDef pending fill:#fafafa,stroke:#bdbdbd,stroke-width:1px");
+    lines.push(
+      "  classDef suspended fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,stroke-dasharray: 3 3"
+    );
+    return lines.join("\n");
+  }
+  sanitizeNodeId(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, "_");
+  }
+  buildStepLabel(step, showDetails) {
+    let label = step.name;
+    if (showDetails) {
+      const meta = [];
+      if (step.commit) {
+        meta.push("\u{1F4DD}");
+      }
+      if (step.retries && step.retries > 0) {
+        meta.push(`\u21BB${step.retries}`);
+      }
+      if (step.timeout) {
+        meta.push(`\u23F1${step.timeout}ms`);
+      }
+      if (step.when) {
+        meta.push("\u2753");
+      }
+      if (meta.length > 0) {
+        label += `<br/><small>${meta.join(" ")}</small>`;
+      }
+    }
+    return label;
+  }
+  buildStepLabelWithStatus(step, exec, showDetails, showStatus) {
+    let label = step.name;
+    if (showStatus && exec) {
+      label += `<br/><small><b>${exec.status.toUpperCase()}</b></small>`;
+      if (exec.duration) {
+        label += `<br/><small>${exec.duration}ms</small>`;
+      }
+      if (exec.retries > 0) {
+        label += `<br/><small>Retries: ${exec.retries}</small>`;
+      }
+    } else if (showDetails) {
+      const meta = [];
+      if (step.commit) {
+        meta.push("\u{1F4DD}");
+      }
+      if (step.retries && step.retries > 0) {
+        meta.push(`\u21BB${step.retries}`);
+      }
+      if (step.timeout) {
+        meta.push(`\u23F1${step.timeout}ms`);
+      }
+      if (step.when) {
+        meta.push("\u2753");
+      }
+      if (meta.length > 0) {
+        label += `<br/><small>${meta.join(" ")}</small>`;
+      }
+    }
+    return label;
+  }
+  getStatusClass(status) {
+    switch (status) {
+      case "completed":
+        return "completed";
+      case "failed":
+        return "failed";
+      case "compensated":
+      case "compensating":
+        return "compensated";
+      case "skipped":
+        return "skipped";
+      case "suspended":
+        return "suspended";
+      case "running":
+        return "started";
+      default:
+        return "pending";
+    }
+  }
+  getWorkflowFinalStatus(status) {
+    switch (status) {
+      case "completed":
+        return "\u2705 Completed";
+      case "failed":
+        return "\u274C Failed";
+      case "rolled_back":
+        return "\u{1F504} Rolled Back";
+      case "suspended":
+        return "\u23F8 Suspended";
+      default:
+        return status;
+    }
+  }
+  getNextNodeId(steps, currentIndex) {
+    const nextStep = steps[currentIndex + 1];
+    return nextStep ? this.sanitizeNodeId(nextStep.name) : "End";
+  }
+};
+
+
+
+exports.MermaidGenerator = MermaidGenerator;
+//# sourceMappingURL=chunk-6AZNHVEO.cjs.map

package/dist/chunk-6AZNHVEO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core-ci-fix/packages/flux/dist/chunk-6AZNHVEO.cjs","../src/visualization/MermaidGenerator.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core-ci-fix/packages/flux/dist/chunk-6AZNHVEO.cjs","sourcesContent":[null,"import type { StepExecution, WorkflowDefinition, WorkflowState } from '../types'\n\n/**\n * Options for customizing Mermaid diagram generation.\n */\nexport interface MermaidOptions {\n  /** Include detailed step information (retries, timeout, conditions). */\n  showDetails?: boolean\n  /** Include execution history with status colors. */\n  showStatus?: boolean\n  /** Render parallel groups visually. */\n  showParallelGroups?: boolean\n  /** Theme: 'default' | 'dark' | 'forest' | 'neutral'. */\n  theme?: 'default' | 'dark' | 'forest' | 'neutral'\n}\n\n/**\n * Generates Mermaid flowchart diagrams from workflow definitions and execution states.\n *\n * **Features**:\n * - Workflow structure visualization (steps, parallel groups, conditions)\n * - Execution status overlay (completed, failed, compensated)\n * - Detailed metadata (retries, timeout, commit markers)\n *\n * **Use Cases**:\n * - Documentation generation\n * - Debugging workflow execution\n * - Visual workflow design validation\n */\nexport class MermaidGenerator {\n  /**\n   * Generates a Mermaid flowchart from a workflow definition.\n   *\n   * @param definition - The workflow definition to visualize\n   * @param options - Customization options\n   * @returns Mermaid diagram syntax as a string\n   *\n   * @example\n   * ```typescript\n   * const generator = new MermaidGenerator()\n   * const diagram = generator.generateFromDefinition(workflow, {\n   *   showDetails: true,\n   *   showParallelGroups: true\n   * })\n   * console.log(diagram)\n   * ```\n   */\n  generateFromDefinition<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    options: MermaidOptions = {}\n  ): string {\n    const { showDetails = false, showParallelGroups = true, theme = 'default' } = options\n\n    const lines: string[] = []\n    lines.push(`%%{init: {'theme':'${theme}'}}%%`)\n    lines.push('flowchart TD')\n    lines.push(`  Start([Start: ${definition.name}])`)\n\n    let prevNode = 'Start'\n    const parallelGroups = new Map<string, string[]>()\n\n    // First pass: identify parallel groups\n    if (showParallelGroups) {\n      for (const step of definition.steps) {\n        if (step.parallelGroup) {\n          const group = parallelGroups.get(step.parallelGroup) || []\n          group.push(step.name)\n          parallelGroups.set(step.parallelGroup, group)\n        }\n      }\n    }\n\n    const processedGroups = new Set<string>()\n\n    for (let i = 0; i < definition.steps.length; i++) {\n      const step = definition.steps[i]!\n\n      // Handle parallel groups\n      if (step.parallelGroup && showParallelGroups) {\n        if (processedGroups.has(step.parallelGroup)) {\n          continue // Already processed this group\n        }\n        processedGroups.add(step.parallelGroup)\n\n        const groupSteps = parallelGroups.get(step.parallelGroup)!\n        const groupName = `ParallelGroup_${step.parallelGroup}`\n\n        // Create subgraph for parallel execution\n        lines.push(`  subgraph ${groupName}[\" \"]`)\n        lines.push(`    direction LR`)\n\n        for (const stepName of groupSteps) {\n          const s = definition.steps.find((st) => st.name === stepName)!\n          const nodeId = this.sanitizeNodeId(stepName)\n          const label = this.buildStepLabel(s, showDetails)\n          const shape = s.commit ? `[${label}]` : `(${label})`\n          lines.push(`    ${nodeId}${shape}`)\n\n          if (s.compensate) {\n            lines.push(`    ${nodeId}_comp[🔄 Compensate]`)\n            lines.push(`    ${nodeId} -.->|on failure| ${nodeId}_comp`)\n          }\n        }\n\n        lines.push(`  end`)\n        lines.push(`  ${prevNode} --> ${groupName}`)\n        prevNode = groupName\n      } else if (!step.parallelGroup) {\n        // Regular sequential step\n        const nodeId = this.sanitizeNodeId(step.name)\n        const label = this.buildStepLabel(step, showDetails)\n        const shape = step.commit ? `[${label}]` : `(${label})`\n\n        lines.push(`  ${nodeId}${shape}`)\n\n        // Handle conditional steps\n        if (step.when) {\n          const condId = `${nodeId}_cond`\n          lines.push(`  ${condId}{Condition?}`)\n          lines.push(`  ${prevNode} --> ${condId}`)\n          lines.push(`  ${condId} -->|yes| ${nodeId}`)\n          lines.push(`  ${condId} -->|no| ${this.getNextNodeId(definition.steps, i)}`)\n          prevNode = nodeId\n        } else {\n          lines.push(`  ${prevNode} --> ${nodeId}`)\n          prevNode = nodeId\n        }\n\n        // Show compensation\n        if (step.compensate) {\n          lines.push(`  ${nodeId}_comp[🔄 Compensate]`)\n          lines.push(`  ${nodeId} -.->|on failure| ${nodeId}_comp`)\n        }\n      }\n    }\n\n    lines.push(`  ${prevNode} --> End([End])`)\n\n    // Add styling\n    lines.push('')\n    lines.push('  classDef commitStep fill:#e1f5e1,stroke:#4caf50,stroke-width:2px')\n    lines.push('  classDef normalStep fill:#e3f2fd,stroke:#2196f3,stroke-width:2px')\n    lines.push(\n      '  classDef compensateStep fill:#fff3e0,stroke:#ff9800,stroke-width:1px,stroke-dasharray: 5 5'\n    )\n\n    return lines.join('\\n')\n  }\n\n  /**\n   * Generates a Mermaid flowchart from a workflow execution state.\n   * Overlays execution status (completed, failed, compensated) on top of the structure.\n   *\n   * @param definition - The workflow definition\n   * @param state - The current execution state\n   * @param options - Customization options\n   * @returns Mermaid diagram syntax with status overlay\n   *\n   * @example\n   * ```typescript\n   * const diagram = generator.generateFromState(workflow, executionState, {\n   *   showStatus: true,\n   *   showDetails: true\n   * })\n   * ```\n   */\n  generateFromState<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    state: WorkflowState<TInput, TData>,\n    options: MermaidOptions = {}\n  ): string {\n    const {\n      showDetails = true,\n      showStatus = true,\n      showParallelGroups = true,\n      theme = 'default',\n    } = options\n\n    const lines: string[] = []\n    lines.push(`%%{init: {'theme':'${theme}'}}%%`)\n    lines.push('flowchart TD')\n    lines.push(`  Start([Start: ${definition.name}])`)\n    lines.push(`  Start:::started`)\n\n    let prevNode = 'Start'\n    const parallelGroups = new Map<string, string[]>()\n    const executionMap = new Map<string, StepExecution>()\n\n    // Build execution map\n    for (const exec of state.history) {\n      executionMap.set(exec.name, exec)\n    }\n\n    // Identify parallel groups\n    if (showParallelGroups) {\n      for (const step of definition.steps) {\n        if (step.parallelGroup) {\n          const group = parallelGroups.get(step.parallelGroup) || []\n          group.push(step.name)\n          parallelGroups.set(step.parallelGroup, group)\n        }\n      }\n    }\n\n    const processedGroups = new Set<string>()\n\n    for (let i = 0; i < definition.steps.length; i++) {\n      const step = definition.steps[i]!\n\n      // Handle parallel groups\n      if (step.parallelGroup && showParallelGroups) {\n        if (processedGroups.has(step.parallelGroup)) {\n          continue\n        }\n        processedGroups.add(step.parallelGroup)\n\n        const groupSteps = parallelGroups.get(step.parallelGroup)!\n        const groupName = `ParallelGroup_${step.parallelGroup}`\n\n        lines.push(`  subgraph ${groupName}[\" \"]`)\n        lines.push(`    direction LR`)\n\n        for (const stepName of groupSteps) {\n          const s = definition.steps.find((st) => st.name === stepName)!\n          const nodeId = this.sanitizeNodeId(stepName)\n          const exec = executionMap.get(stepName)\n          const label = this.buildStepLabelWithStatus(s, exec, showDetails, showStatus)\n          const shape = s.commit ? `[${label}]` : `(${label})`\n\n          lines.push(`    ${nodeId}${shape}`)\n\n          if (exec && showStatus) {\n            const statusClass = this.getStatusClass(exec.status)\n            lines.push(`    ${nodeId}:::${statusClass}`)\n          }\n\n          if (s.compensate && exec?.status === 'compensated') {\n            lines.push(`    ${nodeId}_comp[🔄 Compensated]`)\n            lines.push(`    ${nodeId}_comp:::compensated`)\n            lines.push(`    ${nodeId} -.->|rolled back| ${nodeId}_comp`)\n          }\n        }\n\n        lines.push(`  end`)\n        lines.push(`  ${prevNode} --> ${groupName}`)\n        prevNode = groupName\n      } else if (!step.parallelGroup) {\n        const nodeId = this.sanitizeNodeId(step.name)\n        const exec = executionMap.get(step.name)\n        const label = this.buildStepLabelWithStatus(step, exec, showDetails, showStatus)\n        const shape = step.commit ? `[${label}]` : `(${label})`\n\n        lines.push(`  ${nodeId}${shape}`)\n\n        if (exec && showStatus) {\n          const statusClass = this.getStatusClass(exec.status)\n          lines.push(`  ${nodeId}:::${statusClass}`)\n        }\n\n        if (step.when) {\n          const condId = `${nodeId}_cond`\n          const skipped = exec?.status === 'skipped'\n          lines.push(`  ${condId}{Condition?}`)\n          lines.push(`  ${prevNode} --> ${condId}`)\n\n          if (skipped) {\n            lines.push(`  ${condId}:::skipped`)\n            lines.push(`  ${condId} -->|no| ${nodeId}`)\n          } else {\n            lines.push(`  ${condId} -->|yes| ${nodeId}`)\n          }\n        } else {\n          lines.push(`  ${prevNode} --> ${nodeId}`)\n        }\n\n        if (step.compensate && exec?.status === 'compensated') {\n          lines.push(`  ${nodeId}_comp[🔄 Compensated]`)\n          lines.push(`  ${nodeId}_comp:::compensated`)\n          lines.push(`  ${nodeId} -.->|rolled back| ${nodeId}_comp`)\n        }\n\n        prevNode = nodeId\n      }\n    }\n\n    const finalStatus = this.getWorkflowFinalStatus(state.status)\n    lines.push(`  ${prevNode} --> End([End: ${finalStatus}])`)\n    lines.push(`  End:::${this.getStatusClass(state.status)}`)\n\n    // Add status-based styling\n    lines.push('')\n    lines.push('  classDef started fill:#e3f2fd,stroke:#2196f3,stroke-width:2px')\n    lines.push('  classDef completed fill:#e8f5e9,stroke:#4caf50,stroke-width:2px')\n    lines.push('  classDef failed fill:#ffebee,stroke:#f44336,stroke-width:2px')\n    lines.push('  classDef compensated fill:#fff3e0,stroke:#ff9800,stroke-width:2px')\n    lines.push(\n      '  classDef skipped fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px,stroke-dasharray: 5 5'\n    )\n    lines.push('  classDef pending fill:#fafafa,stroke:#bdbdbd,stroke-width:1px')\n    lines.push(\n      '  classDef suspended fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,stroke-dasharray: 3 3'\n    )\n\n    return lines.join('\\n')\n  }\n\n  private sanitizeNodeId(name: string): string {\n    return name.replace(/[^a-zA-Z0-9_]/g, '_')\n  }\n\n  private buildStepLabel(step: any, showDetails: boolean): string {\n    let label = step.name\n\n    if (showDetails) {\n      const meta: string[] = []\n      if (step.commit) {\n        meta.push('📝')\n      }\n      if (step.retries && step.retries > 0) {\n        meta.push(`↻${step.retries}`)\n      }\n      if (step.timeout) {\n        meta.push(`⏱${step.timeout}ms`)\n      }\n      if (step.when) {\n        meta.push('❓')\n      }\n\n      if (meta.length > 0) {\n        label += `<br/><small>${meta.join(' ')}</small>`\n      }\n    }\n\n    return label\n  }\n\n  private buildStepLabelWithStatus(\n    step: any,\n    exec: StepExecution | undefined,\n    showDetails: boolean,\n    showStatus: boolean\n  ): string {\n    let label = step.name\n\n    if (showStatus && exec) {\n      label += `<br/><small><b>${exec.status.toUpperCase()}</b></small>`\n\n      if (exec.duration) {\n        label += `<br/><small>${exec.duration}ms</small>`\n      }\n\n      if (exec.retries > 0) {\n        label += `<br/><small>Retries: ${exec.retries}</small>`\n      }\n    } else if (showDetails) {\n      const meta: string[] = []\n      if (step.commit) {\n        meta.push('📝')\n      }\n      if (step.retries && step.retries > 0) {\n        meta.push(`↻${step.retries}`)\n      }\n      if (step.timeout) {\n        meta.push(`⏱${step.timeout}ms`)\n      }\n      if (step.when) {\n        meta.push('❓')\n      }\n\n      if (meta.length > 0) {\n        label += `<br/><small>${meta.join(' ')}</small>`\n      }\n    }\n\n    return label\n  }\n\n  private getStatusClass(status: string): string {\n    switch (status) {\n      case 'completed':\n        return 'completed'\n      case 'failed':\n        return 'failed'\n      case 'compensated':\n      case 'compensating':\n        return 'compensated'\n      case 'skipped':\n        return 'skipped'\n      case 'suspended':\n        return 'suspended'\n      case 'running':\n        return 'started'\n      default:\n        return 'pending'\n    }\n  }\n\n  private getWorkflowFinalStatus(status: string): string {\n    switch (status) {\n      case 'completed':\n        return '✅ Completed'\n      case 'failed':\n        return '❌ Failed'\n      case 'rolled_back':\n        return '🔄 Rolled Back'\n      case 'suspended':\n        return '⏸ Suspended'\n      default:\n        return status\n    }\n  }\n\n  private getNextNodeId(steps: any[], currentIndex: number): string {\n    const nextStep = steps[currentIndex + 1]\n    return nextStep ? this.sanitizeNodeId(nextStep.name) : 'End'\n  }\n}\n"]}

package/dist/{chunk-ZAMVC732.js → chunk-NAIVO7RR.js}

@@ -4,12 +4,21 @@ var BunSQLiteStorage = class {
   db;
   tableName;
   initialized = false;
+  /**
+   * Creates a new instance of BunSQLiteStorage.
+   *
+   * @param options - Configuration for the database connection and table naming.
+   */
   constructor(options = {}) {
     this.db = new Database(options.path ?? ":memory:");
     this.tableName = options.tableName ?? "flux_workflows";
   }
   /**
-   * Initialize storage (create tables)
+   * Initializes the database schema and required indexes.
+   *
+   * This method is idempotent and will be called automatically by other operations if not invoked manually.
+   *
+   * @throws {Error} If the database schema cannot be created or indexes fail to initialize.
    */
   async init() {
     if (this.initialized) {
@@ -27,7 +36,9 @@ var BunSQLiteStorage = class {
         error TEXT,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL,
-        completed_at TEXT
+        completed_at TEXT,
+        version INTEGER NOT NULL DEFAULT 1,
+        definition_version TEXT
       )
     `);
     this.db.run(`
@@ -45,14 +56,19 @@ var BunSQLiteStorage = class {
     this.initialized = true;
   }
   /**
-   * Save workflow state
+   * Persists or updates a workflow state in the database.
+   *
+   * Uses an "INSERT OR REPLACE" strategy to ensure the latest state is always stored for a given ID.
+   *
+   * @param state - The current state of the workflow to be saved.
+   * @throws {Error} If the database write operation fails or serialization errors occur.
    */
   async save(state) {
     await this.init();
     const stmt = this.db.prepare(`
       INSERT OR REPLACE INTO ${this.tableName} 
-      (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at)
-      VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)
+      (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at, version, definition_version)
+      VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt, $version, $definitionVersion)
     `);
     stmt.run({
       $id: state.id,
@@ -65,11 +81,17 @@ var BunSQLiteStorage = class {
       $error: state.error ?? null,
       $createdAt: state.createdAt.toISOString(),
       $updatedAt: state.updatedAt.toISOString(),
-      $completedAt: state.completedAt?.toISOString() ?? null
+      $completedAt: state.completedAt?.toISOString() ?? null,
+      $version: state.version,
+      $definitionVersion: state.definitionVersion ?? null
     });
   }
   /**
-   * Load workflow state by ID
+   * Retrieves a workflow state by its unique identifier.
+   *
+   * @param id - The unique ID of the workflow to load.
+   * @returns The reconstructed workflow state, or null if no record is found.
+   * @throws {Error} If the database query fails or deserialization of stored JSON fails.
    */
   async load(id) {
     await this.init();
@@ -83,7 +105,13 @@ var BunSQLiteStorage = class {
     return this.rowToState(row);
   }
   /**
-   * List workflow states with optional filter
+   * Lists workflow states based on the provided filtering criteria.
+   *
+   * Results are returned in descending order of creation time.
+   *
+   * @param filter - Criteria for filtering and paginating the results.
+   * @returns An array of workflow states matching the filter.
+   * @throws {Error} If the database query fails.
    */
   async list(filter) {
     await this.init();
@@ -105,6 +133,10 @@ var BunSQLiteStorage = class {
         params.$status = filter.status;
       }
     }
+    if (filter?.version) {
+      query += " AND definition_version = $version";
+      params.$version = filter.version;
+    }
     query += " ORDER BY created_at DESC";
     if (filter?.limit) {
       query += " LIMIT $limit";
@@ -119,7 +151,10 @@ var BunSQLiteStorage = class {
     return rows.map((row) => this.rowToState(row));
   }
   /**
-   * Delete workflow state
+   * Deletes a workflow state from the database.
+   *
+   * @param id - The unique ID of the workflow to delete.
+   * @throws {Error} If the database deletion fails.
    */
   async delete(id) {
     await this.init();
@@ -129,14 +164,20 @@ var BunSQLiteStorage = class {
     stmt.run({ $id: id });
   }
   /**
-   * Close database connection
+   * Closes the database connection and resets the initialization state.
+   *
+   * @throws {Error} If the database connection cannot be closed cleanly.
    */
   async close() {
     this.db.close();
     this.initialized = false;
   }
   /**
-   * Convert SQLite row to WorkflowState
+   * Converts a raw database row into a structured WorkflowState object.
+   *
+   * @param row - The raw SQLite row data.
+   * @returns The parsed workflow state.
+   * @private
    */
   rowToState(row) {
     return {
@@ -150,17 +191,25 @@ var BunSQLiteStorage = class {
       error: row.error ?? void 0,
       createdAt: new Date(row.created_at),
       updatedAt: new Date(row.updated_at),
-      completedAt: row.completed_at ? new Date(row.completed_at) : void 0
+      completedAt: row.completed_at ? new Date(row.completed_at) : void 0,
+      version: row.version,
+      definitionVersion: row.definition_version ?? void 0
     };
   }
   /**
-   * Get raw database (for advanced usage)
+   * Provides direct access to the underlying Bun SQLite Database instance.
+   *
+   * Useful for performing custom queries or maintenance tasks.
+   *
+   * @returns The raw Database instance.
    */
   getDatabase() {
     return this.db;
   }
   /**
-   * Run a vacuum to optimize database
+   * Performs a VACUUM operation to reclaim unused space and defragment the database.
+   *
+   * @throws {Error} If the VACUUM operation fails.
    */
   vacuum() {
     this.db.run("VACUUM");
@@ -170,4 +219,4 @@ var BunSQLiteStorage = class {
 export {
   BunSQLiteStorage
 };
-//# sourceMappingURL=chunk-ZAMVC732.js.map
+//# sourceMappingURL=chunk-NAIVO7RR.js.map

package/dist/chunk-NAIVO7RR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/BunSQLiteStorage.ts"],"sourcesContent":["import { Database } from 'bun:sqlite'\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * Configuration options for the Bun SQLite storage adapter.\n */\nexport interface BunSQLiteStorageOptions {\n  /**\n   * Path to the SQLite database file.\n   * Use ':memory:' for an ephemeral in-memory database.\n   */\n  path?: string\n  /**\n   * Name of the table used to store workflow states.\n   */\n  tableName?: string\n}\n\n/**\n * BunSQLiteStorage provides a persistent storage backend for Flux workflows using Bun's native SQLite module.\n *\n * It handles automatic table creation, indexing for performance, and serialization of workflow state\n * into a relational format.\n *\n * @example\n * ```typescript\n * const storage = new BunSQLiteStorage({\n *   path: './workflows.db',\n *   tableName: 'my_workflows'\n * });\n * await storage.init();\n * ```\n */\nexport class BunSQLiteStorage implements WorkflowStorage {\n  private db: Database\n  private tableName: string\n  private initialized = false\n\n  /**\n   * Creates a new instance of BunSQLiteStorage.\n   *\n   * @param options - Configuration for the database connection and table naming.\n   */\n  constructor(options: BunSQLiteStorageOptions = {}) {\n    this.db = new Database(options.path ?? ':memory:')\n    this.tableName = options.tableName ?? 'flux_workflows'\n  }\n\n  /**\n   * Initializes the database schema and required indexes.\n   *\n   * This method is idempotent and will be called automatically by other operations if not invoked manually.\n   *\n   * @throws {Error} If the database schema cannot be created or indexes fail to initialize.\n   */\n  async init(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    this.db.run(`\n      CREATE TABLE IF NOT EXISTS ${this.tableName} (\n        id TEXT PRIMARY KEY,\n        name TEXT NOT NULL,\n        status TEXT NOT NULL,\n        input TEXT NOT NULL,\n        data TEXT NOT NULL,\n        current_step INTEGER NOT NULL,\n        history TEXT NOT NULL,\n        error TEXT,\n        created_at TEXT NOT NULL,\n        updated_at TEXT NOT NULL,\n        completed_at TEXT,\n        version INTEGER NOT NULL DEFAULT 1,\n        definition_version TEXT\n      )\n    `)\n\n    this.db.run(`\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_name \n      ON ${this.tableName}(name)\n    `)\n    this.db.run(`\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status \n      ON ${this.tableName}(status)\n    `)\n    this.db.run(`\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_created \n      ON ${this.tableName}(created_at DESC)\n    `)\n\n    this.initialized = true\n  }\n\n  /**\n   * Persists or updates a workflow state in the database.\n   *\n   * Uses an \"INSERT OR REPLACE\" strategy to ensure the latest state is always stored for a given ID.\n   *\n   * @param state - The current state of the workflow to be saved.\n   * @throws {Error} If the database write operation fails or serialization errors occur.\n   */\n  async save(state: WorkflowState): Promise<void> {\n    await this.init()\n\n    const stmt = this.db.prepare(`\n      INSERT OR REPLACE INTO ${this.tableName} \n      (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at, version, definition_version)\n      VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt, $version, $definitionVersion)\n    `)\n\n    stmt.run({\n      $id: state.id,\n      $name: state.name,\n      $status: state.status,\n      $input: JSON.stringify(state.input),\n      $data: JSON.stringify(state.data),\n      $currentStep: state.currentStep,\n      $history: JSON.stringify(state.history),\n      $error: state.error ?? null,\n      $createdAt: state.createdAt.toISOString(),\n      $updatedAt: state.updatedAt.toISOString(),\n      $completedAt: state.completedAt?.toISOString() ?? null,\n      $version: state.version,\n      $definitionVersion: state.definitionVersion ?? null,\n    })\n  }\n\n  /**\n   * Retrieves a workflow state by its unique identifier.\n   *\n   * @param id - The unique ID of the workflow to load.\n   * @returns The reconstructed workflow state, or null if no record is found.\n   * @throws {Error} If the database query fails or deserialization of stored JSON fails.\n   */\n  async load(id: string): Promise<WorkflowState | null> {\n    await this.init()\n\n    const stmt = this.db.prepare(`\n      SELECT * FROM ${this.tableName} WHERE id = $id\n    `)\n\n    const row = stmt.get({ $id: id }) as SQLiteRow | null\n\n    if (!row) {\n      return null\n    }\n\n    return this.rowToState(row)\n  }\n\n  /**\n   * Lists workflow states based on the provided filtering criteria.\n   *\n   * Results are returned in descending order of creation time.\n   *\n   * @param filter - Criteria for filtering and paginating the results.\n   * @returns An array of workflow states matching the filter.\n   * @throws {Error} If the database query fails.\n   */\n  async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n    await this.init()\n\n    let query = `SELECT * FROM ${this.tableName} WHERE 1=1`\n    const params: Record<string, unknown> = {}\n\n    if (filter?.name) {\n      query += ' AND name = $name'\n      params.$name = filter.name\n    }\n\n    if (filter?.status) {\n      if (Array.isArray(filter.status)) {\n        const placeholders = filter.status.map((_, i) => `$status${i}`).join(', ')\n        query += ` AND status IN (${placeholders})`\n        filter.status.forEach((s, i) => {\n          params[`$status${i}`] = s\n        })\n      } else {\n        query += ' AND status = $status'\n        params.$status = filter.status\n      }\n    }\n\n    if (filter?.version) {\n      query += ' AND definition_version = $version'\n      params.$version = filter.version\n    }\n\n    query += ' ORDER BY created_at DESC'\n\n    if (filter?.limit) {\n      query += ' LIMIT $limit'\n      params.$limit = filter.limit\n    }\n\n    if (filter?.offset) {\n      query += ' OFFSET $offset'\n      params.$offset = filter.offset\n    }\n\n    const stmt = this.db.prepare(query)\n    const rows = stmt.all(params as Record<string, any>) as SQLiteRow[]\n\n    return rows.map((row) => this.rowToState(row))\n  }\n\n  /**\n   * Deletes a workflow state from the database.\n   *\n   * @param id - The unique ID of the workflow to delete.\n   * @throws {Error} If the database deletion fails.\n   */\n  async delete(id: string): Promise<void> {\n    await this.init()\n\n    const stmt = this.db.prepare(`\n      DELETE FROM ${this.tableName} WHERE id = $id\n    `)\n\n    stmt.run({ $id: id })\n  }\n\n  /**\n   * Closes the database connection and resets the initialization state.\n   *\n   * @throws {Error} If the database connection cannot be closed cleanly.\n   */\n  async close(): Promise<void> {\n    this.db.close()\n    this.initialized = false\n  }\n\n  /**\n   * Converts a raw database row into a structured WorkflowState object.\n   *\n   * @param row - The raw SQLite row data.\n   * @returns The parsed workflow state.\n   * @private\n   */\n  private rowToState(row: SQLiteRow): WorkflowState {\n    return {\n      id: row.id,\n      name: row.name,\n      status: row.status as WorkflowState['status'],\n      input: JSON.parse(row.input),\n      data: JSON.parse(row.data),\n      currentStep: row.current_step,\n      history: JSON.parse(row.history),\n      error: row.error ?? undefined,\n      createdAt: new Date(row.created_at),\n      updatedAt: new Date(row.updated_at),\n      completedAt: row.completed_at ? new Date(row.completed_at) : undefined,\n      version: row.version,\n      definitionVersion: row.definition_version ?? undefined,\n    }\n  }\n\n  /**\n   * Provides direct access to the underlying Bun SQLite Database instance.\n   *\n   * Useful for performing custom queries or maintenance tasks.\n   *\n   * @returns The raw Database instance.\n   */\n  getDatabase(): Database {\n    return this.db\n  }\n\n  /**\n   * Performs a VACUUM operation to reclaim unused space and defragment the database.\n   *\n   * @throws {Error} If the VACUUM operation fails.\n   */\n  vacuum(): void {\n    this.db.run('VACUUM')\n  }\n}\n\n/**\n * Internal representation of a workflow record in the SQLite database.\n */\ninterface SQLiteRow {\n  id: string\n  name: string\n  status: string\n  input: string\n  data: string\n  current_step: number\n  history: string\n  error: string | null\n  created_at: string\n  updated_at: string\n  completed_at: string | null\n  version: number\n  definition_version: string | null\n}\n"],"mappings":"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","names":[]}