@gravito/flux 2.0.0 → 3.0.1

package/dist/index.d.ts

@@ -1,29 +1,63 @@
-import { W as WorkflowDefinition, F as FluxWaitResult } from './types-cnIU1O3n.js';
-export { a as FluxConfig, b as FluxLogger, c as FluxResult, d as FluxTraceEvent, e as FluxTraceEventType, f as FluxTraceSink, S as StepDefinition, g as StepDescriptor, h as StepExecution, i as StepResult, j as WorkflowContext, k as WorkflowDescriptor, l as WorkflowFilter, m as WorkflowState, n as WorkflowStatus, o as WorkflowStorage } from './types-cnIU1O3n.js';
+import { W as WorkflowDefinition, F as FluxWaitResult } from './types-CZwYGpou.js';
+export { a as FluxConfig, b as FluxLogger, c as FluxResult, d as FluxTraceEvent, e as FluxTraceEventType, f as FluxTraceSink, S as StepDefinition, g as StepDescriptor, h as StepExecution, i as StepResult, j as WorkflowContext, k as WorkflowDescriptor, l as WorkflowFilter, m as WorkflowState, n as WorkflowStatus, o as WorkflowStorage } from './types-CZwYGpou.js';
 import { FluxEngine } from './index.node.js';
 export { ContextManager, FluxConsoleLogger, FluxSilentLogger, JsonFileTraceSink, MemoryStorage, OrbitFlux, OrbitFluxOptions, StateMachine, StepExecutor, WorkflowBuilder, createWorkflow } from './index.node.js';
 export { BunSQLiteStorage, BunSQLiteStorageOptions } from './bun.js';
+import '@gravito/core';
 import 'bun:sqlite';
 
+/**
+ * Performance metrics captured during a workflow profiling session.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface ProfileMetrics {
+    /** Total wall-clock duration of the workflow execution in milliseconds. */
     durationMs: number;
+    /** Amount of time spent in user-space CPU operations in milliseconds. */
     cpuUserMs: number;
+    /** Amount of time spent in system-space CPU operations in milliseconds. */
     cpuSysMs: number;
+    /** Estimated heap memory increase during execution in bytes. */
     memDeltaBytes: number;
+    /** Ratio of CPU time to wall-clock time (0.0 to 1.0+). Higher values indicate CPU-bound tasks. */
     cpuRatio: number;
 }
+/**
+ * Concurrency recommendations generated by the profiler.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface ProfileRecommendation {
+    /** The identified primary bottleneck type. */
     type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND';
+    /** Maximum safe concurrency considering memory and system stability. */
     safeConcurrency: number;
+    /** Most efficient concurrency level considering CPU utilization. */
     efficientConcurrency: number;
+    /** A suggested range for worker concurrency configuration. */
     suggestedConcurrency: string;
+    /** Detailed explanation for the recommendation. */
     reason: string;
 }
 /**
- * Workflow Profiler
+ * WorkflowProfiler analyzes workflow performance characteristics.
+ *
+ * It measures CPU usage, memory consumption, and execution duration to recommend
+ * optimal concurrency settings for Gravito Quasar workers or high-throughput consumers.
+ *
+ * @example
+ * ```typescript
+ * const profiler = new WorkflowProfiler();
+ * const metrics = await profiler.profile(myWorkflow, { input: 'data' });
+ * const advice = profiler.recommend(metrics);
+ * console.log(advice.suggestedConcurrency);
+ * ```
  *
- * Analyzes workflow performance characteristics to recommend
- * optimal concurrency settings for Consumer workers.
+ * @public
+ * @since 3.0.0
  */
 declare class WorkflowProfiler {
     private engine?;

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   StepExecutor,
   WorkflowBuilder,
   createWorkflow
-} from "./chunk-LULCFPIK.js";
+} from "./chunk-3JGQYHUN.js";
 import {
   BunSQLiteStorage
 } from "./chunk-ZAMVC732.js";
@@ -31,7 +31,7 @@ var WorkflowProfiler = class {
    */
   async profile(workflow, input) {
     try {
-      await this.engine.execute(workflow, input);
+      await this.engine?.execute(workflow, input);
     } catch {
     }
     if (global.gc) {
@@ -40,7 +40,7 @@ var WorkflowProfiler = class {
     const startCpu = process.cpuUsage();
     const startMem = process.memoryUsage().heapUsed;
     const startTime = process.hrtime.bigint();
-    await this.engine.execute(workflow, input);
+    await this.engine?.execute(workflow, input);
     const endTime = process.hrtime.bigint();
     const endCpu = process.cpuUsage(startCpu);
     const endMem = process.memoryUsage().heapUsed;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/profiler/WorkflowProfiler.ts","../src/index.ts"],"sourcesContent":["import * as os from 'os'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { FluxSilentLogger } from '../logger/FluxLogger'\nimport type { WorkflowDefinition } from '../types'\n\nexport interface ProfileMetrics {\n  durationMs: number\n  cpuUserMs: number\n  cpuSysMs: number\n  memDeltaBytes: number\n  cpuRatio: number\n}\n\nexport interface ProfileRecommendation {\n  type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND'\n  safeConcurrency: number\n  efficientConcurrency: number\n  suggestedConcurrency: string\n  reason: string\n}\n\n/**\n * Workflow Profiler\n *\n * Analyzes workflow performance characteristics to recommend\n * optimal concurrency settings for Consumer workers.\n */\nexport class WorkflowProfiler {\n  constructor(private engine?: FluxEngine) {\n    if (!this.engine) {\n      // Default minimal engine for profiling (Silent)\n      this.engine = new FluxEngine({\n        logger: new FluxSilentLogger(),\n      })\n    }\n  }\n\n  /**\n   * Run a profile session for a specific workflow\n   */\n  async profile<TInput>(\n    workflow: WorkflowDefinition<TInput, any>,\n    input: TInput\n  ): Promise<ProfileMetrics> {\n    // 1. Warmup (JIT)\n    try {\n      await this.engine!.execute(workflow, input)\n    } catch {}\n\n    // 2. Measure\n    if (global.gc) {\n      global.gc()\n    }\n\n    const startCpu = process.cpuUsage()\n    const startMem = process.memoryUsage().heapUsed\n    const startTime = process.hrtime.bigint()\n\n    await this.engine!.execute(workflow, input)\n\n    const endTime = process.hrtime.bigint()\n    const endCpu = process.cpuUsage(startCpu)\n    const endMem = process.memoryUsage().heapUsed\n\n    // 3. Calculate\n    const durationNs = Number(endTime - startTime)\n    const durationMs = durationNs / 1_000_000\n    const cpuUserMs = endCpu.user / 1000\n    const cpuSysMs = endCpu.system / 1000\n    const totalCpuMs = cpuUserMs + cpuSysMs\n    const memDeltaBytes = Math.max(0, endMem - startMem) // Clamp to 0\n\n    // CPU Ratio: How much % of the time was spent on CPU vs Waiting\n    const cpuRatio = totalCpuMs / durationMs\n\n    return {\n      durationMs,\n      cpuUserMs,\n      cpuSysMs,\n      memDeltaBytes,\n      cpuRatio,\n    }\n  }\n\n  /**\n   * Generate recommendations based on metrics and current environment\n   */\n  recommend(\n    metrics: ProfileMetrics,\n    config?: { configuredConcurrency?: number }\n  ): ProfileRecommendation {\n    const totalMem = os.totalmem()\n    const cpus = os.cpus().length\n\n    // 1. Analyze Bottleneck Type\n    let type: ProfileRecommendation['type'] = 'IO_BOUND'\n    if (metrics.cpuRatio > 0.5) {\n      type = 'CPU_BOUND'\n    } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {\n      // > 50MB per run\n      type = 'MEMORY_BOUND'\n    }\n\n    // 2. Calculate Limits\n\n    // Memory Limit: Keep 30% buffer for system, divide rest by per-workflow memory\n    const safeMem = totalMem * 0.7\n    // Use at least 1MB as baseline to avoid division by zero or huge numbers\n    const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024)\n    const maxMemConcurrency = Math.floor(safeMem / perInstanceMem)\n\n    // CPU Limit:\n    // If IO Bound (0.2% cpu), we can run many. 100% / 0.2% = 500 tasks per core.\n    // We cap efficiency at a reasonable number to avoid Event Loop Lag density.\n    const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 0.001) // Avoid div by 0\n    const maxCpuConcurrency = Math.floor(cpus * cpuEfficiencyFactor)\n\n    // 3. Synthesize Recommendation\n    const safe = Math.min(maxMemConcurrency, 200) // Hard cap at 200 for sanity\n    let efficient = Math.min(maxCpuConcurrency, 200)\n\n    // If CPU bound, strict limit based on cores\n    if (type === 'CPU_BOUND') {\n      efficient = cpus // 1:1 mapping is best for CPU bound\n    }\n\n    const recommended = Math.min(safe, efficient)\n\n    let reason = ''\n    if (type === 'IO_BOUND') {\n      reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`\n    } else if (type === 'CPU_BOUND') {\n      reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus}) is recommended to prevent blocking.`\n    } else {\n      reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`\n    }\n\n    if (config?.configuredConcurrency && config.configuredConcurrency > recommended) {\n      reason += ` \\n⚠️ Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`\n    }\n\n    return {\n      type,\n      safeConcurrency: safe,\n      efficientConcurrency: efficient,\n      suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,\n      reason,\n    }\n  }\n}\n","/**\n * @fileoverview @gravito/flux - Platform-agnostic Workflow Engine\n *\n * High-performance, type-safe workflow engine with Bun optimizations.\n *\n * @example Basic Usage\n * ```typescript\n * import { FluxEngine, createWorkflow } from '@gravito/flux'\n *\n * const workflow = createWorkflow('order-process')\n *   .input<{ orderId: string }>()\n *   .step('validate', async (ctx) => {\n *     ctx.data.order = await fetchOrder(ctx.input.orderId)\n *   })\n *   .step('process', async (ctx) => {\n *     await processPayment(ctx.data.order)\n *   })\n *   .commit('notify', async (ctx) => {\n *     await sendEmail(ctx.data.order.email)\n *   })\n *\n * const engine = new FluxEngine()\n * const result = await engine.execute(workflow, { orderId: '123' })\n * ```\n *\n * @module @gravito/flux\n */\n\n// Builder\nexport { createWorkflow, WorkflowBuilder } from './builder/WorkflowBuilder'\nexport { ContextManager } from './core/ContextManager'\n// Core (for advanced usage)\nexport { StateMachine } from './core/StateMachine'\nexport { StepExecutor } from './core/StepExecutor'\n// Core\nexport { FluxEngine } from './engine/FluxEngine'\n// Logger\nexport { FluxConsoleLogger, FluxSilentLogger } from './logger/FluxLogger'\n// Gravito Integration\nexport { OrbitFlux, type OrbitFluxOptions } from './orbit/OrbitFlux'\n// Profiler\nexport {\n  type ProfileMetrics,\n  type ProfileRecommendation,\n  WorkflowProfiler,\n} from './profiler/WorkflowProfiler'\nexport { BunSQLiteStorage, type BunSQLiteStorageOptions } from './storage/BunSQLiteStorage'\n// Storage\nexport { MemoryStorage } from './storage/MemoryStorage'\n// Trace\nexport { JsonFileTraceSink } from './trace/JsonFileTraceSink'\n\n// Types\nexport type {\n  // Config\n  FluxConfig,\n  // Logger\n  FluxLogger,\n  FluxResult,\n  // Trace\n  FluxTraceEvent,\n  FluxTraceEventType,\n  FluxTraceSink,\n  // Helper\n  FluxWaitResult,\n  // Step types\n  StepDefinition,\n  StepDescriptor,\n  StepExecution,\n  StepResult,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowDescriptor,\n  WorkflowFilter,\n  WorkflowState,\n  // Core types\n  WorkflowStatus,\n  // Storage\n  WorkflowStorage,\n} from './types'\n\n/**\n * Flux helper utilities\n */\nexport const Flux = {\n  /**\n   * Suspend workflow execution and wait for a signal\n   *\n   * @param signal - Signal name to wait for\n   */\n  wait: (signal: string): import('./types').FluxWaitResult => ({\n    __kind: 'flux_wait',\n    signal,\n  }),\n}\n"],"mappings":"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","names":["cpus"]}
+{"version":3,"sources":["../src/profiler/WorkflowProfiler.ts","../src/index.ts"],"sourcesContent":["import * as os from 'node:os'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { FluxSilentLogger } from '../logger/FluxLogger'\nimport type { WorkflowDefinition } from '../types'\n\n/**\n * Performance metrics captured during a workflow profiling session.\n *\n * @public\n * @since 3.0.0\n */\nexport interface ProfileMetrics {\n  /** Total wall-clock duration of the workflow execution in milliseconds. */\n  durationMs: number\n  /** Amount of time spent in user-space CPU operations in milliseconds. */\n  cpuUserMs: number\n  /** Amount of time spent in system-space CPU operations in milliseconds. */\n  cpuSysMs: number\n  /** Estimated heap memory increase during execution in bytes. */\n  memDeltaBytes: number\n  /** Ratio of CPU time to wall-clock time (0.0 to 1.0+). Higher values indicate CPU-bound tasks. */\n  cpuRatio: number\n}\n\n/**\n * Concurrency recommendations generated by the profiler.\n *\n * @public\n * @since 3.0.0\n */\nexport interface ProfileRecommendation {\n  /** The identified primary bottleneck type. */\n  type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND'\n  /** Maximum safe concurrency considering memory and system stability. */\n  safeConcurrency: number\n  /** Most efficient concurrency level considering CPU utilization. */\n  efficientConcurrency: number\n  /** A suggested range for worker concurrency configuration. */\n  suggestedConcurrency: string\n  /** Detailed explanation for the recommendation. */\n  reason: string\n}\n\n/**\n * WorkflowProfiler analyzes workflow performance characteristics.\n *\n * It measures CPU usage, memory consumption, and execution duration to recommend\n * optimal concurrency settings for Gravito Quasar workers or high-throughput consumers.\n *\n * @example\n * ```typescript\n * const profiler = new WorkflowProfiler();\n * const metrics = await profiler.profile(myWorkflow, { input: 'data' });\n * const advice = profiler.recommend(metrics);\n * console.log(advice.suggestedConcurrency);\n * ```\n *\n * @public\n * @since 3.0.0\n */\nexport class WorkflowProfiler {\n  constructor(private engine?: FluxEngine) {\n    if (!this.engine) {\n      // Default minimal engine for profiling (Silent)\n      this.engine = new FluxEngine({\n        logger: new FluxSilentLogger(),\n      })\n    }\n  }\n\n  /**\n   * Run a profile session for a specific workflow\n   */\n  async profile<TInput>(\n    workflow: WorkflowDefinition<TInput, any>,\n    input: TInput\n  ): Promise<ProfileMetrics> {\n    // 1. Warmup (JIT)\n    try {\n      await this.engine?.execute(workflow, input)\n    } catch {}\n\n    // 2. Measure\n    if (global.gc) {\n      global.gc()\n    }\n\n    const startCpu = process.cpuUsage()\n    const startMem = process.memoryUsage().heapUsed\n    const startTime = process.hrtime.bigint()\n\n    await this.engine?.execute(workflow, input)\n\n    const endTime = process.hrtime.bigint()\n    const endCpu = process.cpuUsage(startCpu)\n    const endMem = process.memoryUsage().heapUsed\n\n    // 3. Calculate\n    const durationNs = Number(endTime - startTime)\n    const durationMs = durationNs / 1_000_000\n    const cpuUserMs = endCpu.user / 1000\n    const cpuSysMs = endCpu.system / 1000\n    const totalCpuMs = cpuUserMs + cpuSysMs\n    const memDeltaBytes = Math.max(0, endMem - startMem) // Clamp to 0\n\n    // CPU Ratio: How much % of the time was spent on CPU vs Waiting\n    const cpuRatio = totalCpuMs / durationMs\n\n    return {\n      durationMs,\n      cpuUserMs,\n      cpuSysMs,\n      memDeltaBytes,\n      cpuRatio,\n    }\n  }\n\n  /**\n   * Generate recommendations based on metrics and current environment\n   */\n  recommend(\n    metrics: ProfileMetrics,\n    config?: { configuredConcurrency?: number }\n  ): ProfileRecommendation {\n    const totalMem = os.totalmem()\n    const cpus = os.cpus().length\n\n    // 1. Analyze Bottleneck Type\n    let type: ProfileRecommendation['type'] = 'IO_BOUND'\n    if (metrics.cpuRatio > 0.5) {\n      type = 'CPU_BOUND'\n    } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {\n      // > 50MB per run\n      type = 'MEMORY_BOUND'\n    }\n\n    // 2. Calculate Limits\n\n    // Memory Limit: Keep 30% buffer for system, divide rest by per-workflow memory\n    const safeMem = totalMem * 0.7\n    // Use at least 1MB as baseline to avoid division by zero or huge numbers\n    const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024)\n    const maxMemConcurrency = Math.floor(safeMem / perInstanceMem)\n\n    // CPU Limit:\n    // If IO Bound (0.2% cpu), we can run many. 100% / 0.2% = 500 tasks per core.\n    // We cap efficiency at a reasonable number to avoid Event Loop Lag density.\n    const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 0.001) // Avoid div by 0\n    const maxCpuConcurrency = Math.floor(cpus * cpuEfficiencyFactor)\n\n    // 3. Synthesize Recommendation\n    const safe = Math.min(maxMemConcurrency, 200) // Hard cap at 200 for sanity\n    let efficient = Math.min(maxCpuConcurrency, 200)\n\n    // If CPU bound, strict limit based on cores\n    if (type === 'CPU_BOUND') {\n      efficient = cpus // 1:1 mapping is best for CPU bound\n    }\n\n    const recommended = Math.min(safe, efficient)\n\n    let reason = ''\n    if (type === 'IO_BOUND') {\n      reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`\n    } else if (type === 'CPU_BOUND') {\n      reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus}) is recommended to prevent blocking.`\n    } else {\n      reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`\n    }\n\n    if (config?.configuredConcurrency && config.configuredConcurrency > recommended) {\n      reason += ` \\n⚠️ Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`\n    }\n\n    return {\n      type,\n      safeConcurrency: safe,\n      efficientConcurrency: efficient,\n      suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,\n      reason,\n    }\n  }\n}\n","/**\n * @fileoverview @gravito/flux - Platform-agnostic Workflow Engine\n *\n * High-performance, type-safe workflow engine with Bun optimizations.\n *\n * @example Basic Usage\n * ```typescript\n * import { FluxEngine, createWorkflow } from '@gravito/flux'\n *\n * const workflow = createWorkflow('order-process')\n *   .input<{ orderId: string }>()\n *   .step('validate', async (ctx) => {\n *     ctx.data.order = await fetchOrder(ctx.input.orderId)\n *   })\n *   .step('process', async (ctx) => {\n *     await processPayment(ctx.data.order)\n *   })\n *   .commit('notify', async (ctx) => {\n *     await sendEmail(ctx.data.order.email)\n *   })\n *\n * const engine = new FluxEngine()\n * const result = await engine.execute(workflow, { orderId: '123' })\n * ```\n *\n * @module @gravito/flux\n */\n\n// Builder\nexport { createWorkflow, WorkflowBuilder } from './builder/WorkflowBuilder'\nexport { ContextManager } from './core/ContextManager'\n// Core (for advanced usage)\nexport { StateMachine } from './core/StateMachine'\nexport { StepExecutor } from './core/StepExecutor'\n// Core\nexport { FluxEngine } from './engine/FluxEngine'\n// Logger\nexport { FluxConsoleLogger, FluxSilentLogger } from './logger/FluxLogger'\n// Gravito Integration\nexport { OrbitFlux, type OrbitFluxOptions } from './orbit/OrbitFlux'\n// Profiler\nexport {\n  type ProfileMetrics,\n  type ProfileRecommendation,\n  WorkflowProfiler,\n} from './profiler/WorkflowProfiler'\nexport { BunSQLiteStorage, type BunSQLiteStorageOptions } from './storage/BunSQLiteStorage'\n// Storage\nexport { MemoryStorage } from './storage/MemoryStorage'\n// Trace\nexport { JsonFileTraceSink } from './trace/JsonFileTraceSink'\n\n// Types\nexport type {\n  // Config\n  FluxConfig,\n  // Logger\n  FluxLogger,\n  FluxResult,\n  // Trace\n  FluxTraceEvent,\n  FluxTraceEventType,\n  FluxTraceSink,\n  // Helper\n  FluxWaitResult,\n  // Step types\n  StepDefinition,\n  StepDescriptor,\n  StepExecution,\n  StepResult,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowDescriptor,\n  WorkflowFilter,\n  WorkflowState,\n  // Core types\n  WorkflowStatus,\n  // Storage\n  WorkflowStorage,\n} from './types'\n\n/**\n * Flux helper utilities\n */\nexport const Flux = {\n  /**\n   * Suspend workflow execution and wait for a signal\n   *\n   * @param signal - Signal name to wait for\n   */\n  wait: (signal: string): import('./types').FluxWaitResult => ({\n    __kind: 'flux_wait',\n    signal,\n  }),\n}\n"],"mappings":"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","names":["cpus"]}

package/dist/index.node.cjs

@@ -10,7 +10,7 @@
 
 
 
-var _chunkX3NC7HS4cjs = require('./chunk-X3NC7HS4.cjs');
+var _chunk5OXXH442cjs = require('./chunk-5OXXH442.cjs');
 require('./chunk-SJSPR4ZU.cjs');
 
 
@@ -24,5 +24,5 @@ require('./chunk-SJSPR4ZU.cjs');
 
 
 
-exports.ContextManager = _chunkX3NC7HS4cjs.ContextManager; exports.FluxConsoleLogger = _chunkX3NC7HS4cjs.FluxConsoleLogger; exports.FluxEngine = _chunkX3NC7HS4cjs.FluxEngine; exports.FluxSilentLogger = _chunkX3NC7HS4cjs.FluxSilentLogger; exports.JsonFileTraceSink = _chunkX3NC7HS4cjs.JsonFileTraceSink; exports.MemoryStorage = _chunkX3NC7HS4cjs.MemoryStorage; exports.OrbitFlux = _chunkX3NC7HS4cjs.OrbitFlux; exports.StateMachine = _chunkX3NC7HS4cjs.StateMachine; exports.StepExecutor = _chunkX3NC7HS4cjs.StepExecutor; exports.WorkflowBuilder = _chunkX3NC7HS4cjs.WorkflowBuilder; exports.createWorkflow = _chunkX3NC7HS4cjs.createWorkflow;
+exports.ContextManager = _chunk5OXXH442cjs.ContextManager; exports.FluxConsoleLogger = _chunk5OXXH442cjs.FluxConsoleLogger; exports.FluxEngine = _chunk5OXXH442cjs.FluxEngine; exports.FluxSilentLogger = _chunk5OXXH442cjs.FluxSilentLogger; exports.JsonFileTraceSink = _chunk5OXXH442cjs.JsonFileTraceSink; exports.MemoryStorage = _chunk5OXXH442cjs.MemoryStorage; exports.OrbitFlux = _chunk5OXXH442cjs.OrbitFlux; exports.StateMachine = _chunk5OXXH442cjs.StateMachine; exports.StepExecutor = _chunk5OXXH442cjs.StepExecutor; exports.WorkflowBuilder = _chunk5OXXH442cjs.WorkflowBuilder; exports.createWorkflow = _chunk5OXXH442cjs.createWorkflow;
 //# sourceMappingURL=index.node.cjs.map

package/dist/index.node.d.cts

@@ -1,5 +1,6 @@
-import { j as WorkflowContext, F as FluxWaitResult, W as WorkflowDefinition, k as WorkflowDescriptor, a as FluxConfig, c as FluxResult, m as WorkflowState, o as WorkflowStorage, l as WorkflowFilter, f as FluxTraceSink, d as FluxTraceEvent, n as WorkflowStatus, S as StepDefinition, h as StepExecution, i as StepResult, b as FluxLogger } from './types-cnIU1O3n.cjs';
-export { e as FluxTraceEventType, g as StepDescriptor } from './types-cnIU1O3n.cjs';
+import { j as WorkflowContext, F as FluxWaitResult, W as WorkflowDefinition, k as WorkflowDescriptor, a as FluxConfig, c as FluxResult, m as WorkflowState, o as WorkflowStorage, l as WorkflowFilter, f as FluxTraceSink, d as FluxTraceEvent, n as WorkflowStatus, S as StepDefinition, h as StepExecution, i as StepResult, b as FluxLogger } from './types-CZwYGpou.cjs';
+export { e as FluxTraceEventType, g as StepDescriptor } from './types-CZwYGpou.cjs';
+import { GravitoOrbit, PlanetCore } from '@gravito/core';
 
 /**
  * @fileoverview Workflow Builder - Fluent API for defining workflows
@@ -10,39 +11,34 @@ export { e as FluxTraceEventType, g as StepDescriptor } from './types-cnIU1O3n.c
  */
 
 /**
- * Step options
+ * Options for configuring a single step in a workflow.
+ * @public
  */
 interface StepOptions<TInput = any, TData = any> {
+    /** Maximum number of automatic retries on failure (default: 0) */
     retries?: number;
+    /** Maximum execution time in milliseconds before timeout error */
     timeout?: number;
+    /** Predicate to determine if the step should be executed or skipped */
     when?: (ctx: WorkflowContext<TInput, TData>) => boolean;
+    /** Logic to undo the effects of this step if a later step fails */
     compensate?: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void;
 }
 /**
- * Workflow Builder
- *
- * Provides fluent API for defining workflows with type inference.
+ * WorkflowBuilder provides a fluent, type-safe API for defining sequential logic.
  *
  * @example
  * ```typescript
- * const workflow = createWorkflow('order-process')
+ * const myFlow = createWorkflow('process-order')
  *   .input<{ orderId: string }>()
- *   .step('validate', async (ctx) => {
- *     ctx.data.order = await fetchOrder(ctx.input.orderId)
- *   })
- *   .step('process', async (ctx) => {
- *     await processOrder(ctx.data.order)
- *   }, {
- *     compensate: async (ctx) => {
- *       await cancelOrder(ctx.data.order.id)
- *     }
- *   })
- *   .commit('notify', async (ctx) => {
- *     await sendEmail(ctx.data.order.email)
- *   })
+ *   .step('validate', async (ctx) => { ... })
+ *   .step('charge', async (ctx) => { ... }, { compensate: async (ctx) => { ... } })
+ *   .commit('ship', async (ctx) => { ... });
  * ```
+ * @public
  */
 declare class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>> {
+    drum: any;
     private _name;
     private _steps;
     private _validateInput?;
@@ -66,7 +62,7 @@ declare class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>>
     /**
      * Add a step to the workflow
      */
-    step(name: string, handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void | FluxWaitResult> | void | FluxWaitResult, options?: StepOptions<TInput, TData>): this;
+    step(name: string, handler: (ctx: WorkflowContext<TInput, TData>) => void | Promise<void | undefined | FluxWaitResult> | undefined | FluxWaitResult, options?: StepOptions<TInput, TData>): this;
     /**
      * Add a commit step (always executes, even on replay)
      *
@@ -120,22 +116,27 @@ declare function createWorkflow(name: string): WorkflowBuilder;
  */
 
 /**
- * Flux Engine
- *
- * Main workflow execution engine.
+ * FluxEngine is the primary execution orchestrator for workflows.
+ * It manages context lifecycle, persistence via storage adapters,
+ * step execution with retries, and transactional rollbacks (compensation).
  *
  * @example
  * ```typescript
- * const engine = new FluxEngine({ storage: new MemoryStorage() })
+ * const engine = new FluxEngine({
+ *   storage: new BunSQLiteStorage(),
+ *   logger: new FluxConsoleLogger()
+ * });
  *
- * const workflow = createWorkflow('process-order')
- *   .input<{ orderId: string }>()
- *   .step('fetch', async (ctx) => { ... })
- *   .step('validate', async (ctx) => { ... })
- *   .commit('save', async (ctx) => { ... })
+ * const workflow = createWorkflow('onboard-user')
+ *   .step('create-account', async (ctx) => { ... })
+ *   .step('send-email', async (ctx) => { ... });
  *
- * const result = await engine.execute(workflow, { orderId: '123' })
+ * const result = await engine.execute(workflow, { email: 'user@example.com' });
+ * if (result.status === 'completed') {
+ *   console.log('User onboarded successfully');
+ * }
  * ```
+ * @public
  */
 declare class FluxEngine {
     private storage;
@@ -233,10 +234,35 @@ declare class MemoryStorage implements WorkflowStorage {
  * Writes trace events to a newline-delimited JSON file.
  */
 
+/**
+ * Options for configuring the `JsonFileTraceSink`.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface JsonFileTraceSinkOptions {
+    /** Absolute path where the trace file should be stored. */
     path: string;
+    /** Whether to reset (clear) the file on initialization. @default true */
     reset?: boolean;
 }
+/**
+ * A trace sink that writes events to a newline-delimited JSON (NDJSON) file.
+ *
+ * This sink is ideal for local development and debugging as it produces
+ * a human-readable and easily machine-parsable log of workflow events.
+ *
+ * @example
+ * ```typescript
+ * const sink = new JsonFileTraceSink({
+ *   path: './traces/workflow.jsonl',
+ *   reset: true
+ * });
+ * ```
+ *
+ * @public
+ * @since 3.0.0
+ */
 declare class JsonFileTraceSink implements FluxTraceSink {
     private path;
     private ready;
@@ -404,39 +430,6 @@ declare class FluxSilentLogger implements FluxLogger {
     error(): void;
 }
 
-/**
- * @fileoverview OrbitFlux - Gravito PlanetCore Integration
- *
- * Integrates FluxEngine with Gravito's PlanetCore for seamless workflow management.
- *
- * @module @gravito/flux
- */
-
-/**
- * Minimal PlanetCore interface for type compatibility
- * (Avoids importing @gravito/core sources which causes rootDir issues)
- */
-interface PlanetCore {
-    logger: {
-        debug(message: string, ...args: unknown[]): void;
-        info(message: string, ...args: unknown[]): void;
-        warn(message: string, ...args: unknown[]): void;
-        error(message: string, ...args: unknown[]): void;
-    };
-    services: {
-        set(key: string, value: unknown): void;
-        get<T>(key: string): T | undefined;
-    };
-    hooks: {
-        doAction(name: string, payload?: unknown): void;
-    };
-}
-/**
- * GravitoOrbit interface
- */
-interface GravitoOrbit {
-    install(core: PlanetCore): void | Promise<void>;
-}
 /**
  * OrbitFlux configuration options
  */
@@ -484,8 +477,8 @@ interface OrbitFluxOptions {
  *   ]
  * })
  *
- * // Access via services
- * const flux = core.services.get<FluxEngine>('flux')
+ * // Access via container
+ * const flux = core.container.make<FluxEngine>('flux')
  * await flux.execute(myWorkflow, input)
  * ```
  */

package/dist/index.node.d.ts

@@ -1,5 +1,6 @@
-import { j as WorkflowContext, F as FluxWaitResult, W as WorkflowDefinition, k as WorkflowDescriptor, a as FluxConfig, c as FluxResult, m as WorkflowState, o as WorkflowStorage, l as WorkflowFilter, f as FluxTraceSink, d as FluxTraceEvent, n as WorkflowStatus, S as StepDefinition, h as StepExecution, i as StepResult, b as FluxLogger } from './types-cnIU1O3n.js';
-export { e as FluxTraceEventType, g as StepDescriptor } from './types-cnIU1O3n.js';
+import { j as WorkflowContext, F as FluxWaitResult, W as WorkflowDefinition, k as WorkflowDescriptor, a as FluxConfig, c as FluxResult, m as WorkflowState, o as WorkflowStorage, l as WorkflowFilter, f as FluxTraceSink, d as FluxTraceEvent, n as WorkflowStatus, S as StepDefinition, h as StepExecution, i as StepResult, b as FluxLogger } from './types-CZwYGpou.js';
+export { e as FluxTraceEventType, g as StepDescriptor } from './types-CZwYGpou.js';
+import { GravitoOrbit, PlanetCore } from '@gravito/core';
 
 /**
  * @fileoverview Workflow Builder - Fluent API for defining workflows
@@ -10,39 +11,34 @@ export { e as FluxTraceEventType, g as StepDescriptor } from './types-cnIU1O3n.j
  */
 
 /**
- * Step options
+ * Options for configuring a single step in a workflow.
+ * @public
  */
 interface StepOptions<TInput = any, TData = any> {
+    /** Maximum number of automatic retries on failure (default: 0) */
     retries?: number;
+    /** Maximum execution time in milliseconds before timeout error */
     timeout?: number;
+    /** Predicate to determine if the step should be executed or skipped */
     when?: (ctx: WorkflowContext<TInput, TData>) => boolean;
+    /** Logic to undo the effects of this step if a later step fails */
     compensate?: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void;
 }
 /**
- * Workflow Builder
- *
- * Provides fluent API for defining workflows with type inference.
+ * WorkflowBuilder provides a fluent, type-safe API for defining sequential logic.
  *
  * @example
  * ```typescript
- * const workflow = createWorkflow('order-process')
+ * const myFlow = createWorkflow('process-order')
  *   .input<{ orderId: string }>()
- *   .step('validate', async (ctx) => {
- *     ctx.data.order = await fetchOrder(ctx.input.orderId)
- *   })
- *   .step('process', async (ctx) => {
- *     await processOrder(ctx.data.order)
- *   }, {
- *     compensate: async (ctx) => {
- *       await cancelOrder(ctx.data.order.id)
- *     }
- *   })
- *   .commit('notify', async (ctx) => {
- *     await sendEmail(ctx.data.order.email)
- *   })
+ *   .step('validate', async (ctx) => { ... })
+ *   .step('charge', async (ctx) => { ... }, { compensate: async (ctx) => { ... } })
+ *   .commit('ship', async (ctx) => { ... });
  * ```
+ * @public
  */
 declare class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>> {
+    drum: any;
     private _name;
     private _steps;
     private _validateInput?;
@@ -66,7 +62,7 @@ declare class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>>
     /**
      * Add a step to the workflow
      */
-    step(name: string, handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void | FluxWaitResult> | void | FluxWaitResult, options?: StepOptions<TInput, TData>): this;
+    step(name: string, handler: (ctx: WorkflowContext<TInput, TData>) => void | Promise<void | undefined | FluxWaitResult> | undefined | FluxWaitResult, options?: StepOptions<TInput, TData>): this;
     /**
      * Add a commit step (always executes, even on replay)
      *
@@ -120,22 +116,27 @@ declare function createWorkflow(name: string): WorkflowBuilder;
  */
 
 /**
- * Flux Engine
- *
- * Main workflow execution engine.
+ * FluxEngine is the primary execution orchestrator for workflows.
+ * It manages context lifecycle, persistence via storage adapters,
+ * step execution with retries, and transactional rollbacks (compensation).
  *
  * @example
  * ```typescript
- * const engine = new FluxEngine({ storage: new MemoryStorage() })
+ * const engine = new FluxEngine({
+ *   storage: new BunSQLiteStorage(),
+ *   logger: new FluxConsoleLogger()
+ * });
  *
- * const workflow = createWorkflow('process-order')
- *   .input<{ orderId: string }>()
- *   .step('fetch', async (ctx) => { ... })
- *   .step('validate', async (ctx) => { ... })
- *   .commit('save', async (ctx) => { ... })
+ * const workflow = createWorkflow('onboard-user')
+ *   .step('create-account', async (ctx) => { ... })
+ *   .step('send-email', async (ctx) => { ... });
  *
- * const result = await engine.execute(workflow, { orderId: '123' })
+ * const result = await engine.execute(workflow, { email: 'user@example.com' });
+ * if (result.status === 'completed') {
+ *   console.log('User onboarded successfully');
+ * }
  * ```
+ * @public
  */
 declare class FluxEngine {
     private storage;
@@ -233,10 +234,35 @@ declare class MemoryStorage implements WorkflowStorage {
  * Writes trace events to a newline-delimited JSON file.
  */
 
+/**
+ * Options for configuring the `JsonFileTraceSink`.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface JsonFileTraceSinkOptions {
+    /** Absolute path where the trace file should be stored. */
     path: string;
+    /** Whether to reset (clear) the file on initialization. @default true */
     reset?: boolean;
 }
+/**
+ * A trace sink that writes events to a newline-delimited JSON (NDJSON) file.
+ *
+ * This sink is ideal for local development and debugging as it produces
+ * a human-readable and easily machine-parsable log of workflow events.
+ *
+ * @example
+ * ```typescript
+ * const sink = new JsonFileTraceSink({
+ *   path: './traces/workflow.jsonl',
+ *   reset: true
+ * });
+ * ```
+ *
+ * @public
+ * @since 3.0.0
+ */
 declare class JsonFileTraceSink implements FluxTraceSink {
     private path;
     private ready;
@@ -404,39 +430,6 @@ declare class FluxSilentLogger implements FluxLogger {
     error(): void;
 }
 
-/**
- * @fileoverview OrbitFlux - Gravito PlanetCore Integration
- *
- * Integrates FluxEngine with Gravito's PlanetCore for seamless workflow management.
- *
- * @module @gravito/flux
- */
-
-/**
- * Minimal PlanetCore interface for type compatibility
- * (Avoids importing @gravito/core sources which causes rootDir issues)
- */
-interface PlanetCore {
-    logger: {
-        debug(message: string, ...args: unknown[]): void;
-        info(message: string, ...args: unknown[]): void;
-        warn(message: string, ...args: unknown[]): void;
-        error(message: string, ...args: unknown[]): void;
-    };
-    services: {
-        set(key: string, value: unknown): void;
-        get<T>(key: string): T | undefined;
-    };
-    hooks: {
-        doAction(name: string, payload?: unknown): void;
-    };
-}
-/**
- * GravitoOrbit interface
- */
-interface GravitoOrbit {
-    install(core: PlanetCore): void | Promise<void>;
-}
 /**
  * OrbitFlux configuration options
  */
@@ -484,8 +477,8 @@ interface OrbitFluxOptions {
  *   ]
  * })
  *
- * // Access via services
- * const flux = core.services.get<FluxEngine>('flux')
+ * // Access via container
+ * const flux = core.container.make<FluxEngine>('flux')
  * await flux.execute(myWorkflow, input)
  * ```
  */

package/dist/index.node.js

@@ -10,7 +10,7 @@ import {
   StepExecutor,
   WorkflowBuilder,
   createWorkflow
-} from "./chunk-LULCFPIK.js";
+} from "./chunk-3JGQYHUN.js";
 import "./chunk-ZAMVC732.js";
 export {
   ContextManager,