@gravito/flux 3.0.0 → 3.0.2

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 * Used to quantify the resource footprint of a workflow execution, enabling\n * data-driven decisions for infrastructure scaling and concurrency tuning.\n *\n * @public\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 * Provides actionable insights into how many instances of a workflow can safely\n * and efficiently run in parallel on the current hardware.\n *\n * @public\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(`Suggested concurrency: ${advice.suggestedConcurrency}`);\n * ```\n *\n * @public\n */\nexport class WorkflowProfiler {\n  /**\n   * Initializes the profiler with an optional engine.\n   *\n   * @param engine - The FluxEngine instance to use for execution. If omitted, a silent engine is created.\n   */\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   * Executes a workflow and captures its resource consumption metrics.\n   *\n   * Performs a warmup run to ensure JIT optimization before measurement.\n   *\n   * @param workflow - The workflow definition to profile.\n   * @param input - The input data for the workflow execution.\n   * @returns A promise resolving to the captured performance metrics.\n   *\n   * @example\n   * ```typescript\n   * const metrics = await profiler.profile(orderWorkflow, { id: '123' });\n   * console.log(`Duration: ${metrics.durationMs}ms`);\n   * ```\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   * Analyzes metrics to generate concurrency recommendations.\n   *\n   * Considers system CPU cores and total memory to calculate safe and efficient limits.\n   *\n   * @param metrics - The metrics captured during a profiling session.\n   * @param config - Optional current configuration to check against recommendations.\n   * @returns A recommendation object containing bottleneck analysis and concurrency limits.\n   *\n   * @example\n   * ```typescript\n   * const advice = profiler.recommend(metrics, { configuredConcurrency: 10 });\n   * if (advice.type === 'CPU_BOUND') {\n   *   console.warn('Workflow is CPU bound, consider reducing concurrency');\n   * }\n   * ```\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'\nexport { type Lock, type LockProvider, MemoryLockProvider } from './core/LockProvider'\nexport {\n  type RedisClient,\n  RedisLockProvider,\n  type RedisLockProviderOptions,\n} from './core/RedisLockProvider'\n// Core (for advanced usage)\nexport { StateMachine } from './core/StateMachine'\nexport { StepExecutor } from './core/StepExecutor'\nexport {\n  type BatchExecutionOptions,\n  BatchExecutor,\n  type BatchItemResult,\n  type BatchResult,\n} from './engine/BatchExecutor'\n// Core\nexport { FluxEngine } from './engine/FluxEngine'\n// Errors\nexport {\n  cannotRemoveRoot,\n  cannotReplaceRoot,\n  emptyWorkflow,\n  FluxError,\n  FluxErrorCode,\n  invalidInput,\n  invalidJsonPointer,\n  invalidPathTraversal,\n  invalidStateTransition,\n  invalidStepIndex,\n  noRecoveryAction,\n  stepNotFound,\n  workflowDefinitionChanged,\n  workflowNameMismatch,\n  workflowNotFound,\n  workflowNotSuspended,\n} from './errors'\n// Logger\nexport { FluxConsoleLogger, FluxSilentLogger } from './logger/FluxLogger'\nexport { CronTrigger } from './orbit/CronTrigger'\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'\nexport { PostgreSQLStorage, type PostgreSQLStorageOptions } from './storage/PostgreSQLStorage'\n// Trace\nexport { JsonFileTraceSink } from './trace/JsonFileTraceSink'\n// Types\nexport type {\n  CronScheduleOptions,\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// Visualization\nexport { MermaidGenerator, type MermaidOptions } from './visualization/MermaidGenerator'\n\n/**\n * Flux helper utilities for workflow control flow.\n *\n * Provides methods to interact with the workflow engine's special behaviors,\n * such as suspending execution to wait for external signals.\n */\nexport const Flux = {\n  /**\n   * Suspends workflow execution until a specific signal is received.\n   *\n   * When a handler returns this result, the engine saves the current state\n   * and stops execution. The workflow can be resumed later using `engine.signal()`.\n   *\n   * @param signal - The unique identifier for the signal to wait for.\n   * @returns A special result object that instructs the engine to suspend.\n   *\n   * @example\n   * ```typescript\n   * .step('wait-for-approval', async (ctx) => {\n   *   return Flux.wait('manager-approval');\n   * })\n   * ```\n   */\n  wait: (signal: string): import('./types').FluxWaitResult => ({\n    __kind: 'flux_wait',\n    signal,\n  }),\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,YAAY,QAAQ;AA+Db,IAAM,mBAAN,MAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5B,YAAoB,QAAqB;AAArB;AAClB,QAAI,CAAC,KAAK,QAAQ;AAEhB,WAAK,SAAS,IAAI,WAAW;AAAA,QAC3B,QAAQ,IAAI,iBAAiB;AAAA,MAC/B,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,QACJ,UACA,OACyB;AAEzB,QAAI;AACF,YAAM,KAAK,QAAQ,QAAQ,UAAU,KAAK;AAAA,IAC5C,QAAQ;AAAA,IAAC;AAGT,QAAI,OAAO,IAAI;AACb,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,WAAW,QAAQ,SAAS;AAClC,UAAM,WAAW,QAAQ,YAAY,EAAE;AACvC,UAAM,YAAY,QAAQ,OAAO,OAAO;AAExC,UAAM,KAAK,QAAQ,QAAQ,UAAU,KAAK;AAE1C,UAAM,UAAU,QAAQ,OAAO,OAAO;AACtC,UAAM,SAAS,QAAQ,SAAS,QAAQ;AACxC,UAAM,SAAS,QAAQ,YAAY,EAAE;AAGrC,UAAM,aAAa,OAAO,UAAU,SAAS;AAC7C,UAAM,aAAa,aAAa;AAChC,UAAM,YAAY,OAAO,OAAO;AAChC,UAAM,WAAW,OAAO,SAAS;AACjC,UAAM,aAAa,YAAY;AAC/B,UAAM,gBAAgB,KAAK,IAAI,GAAG,SAAS,QAAQ;AAGnD,UAAM,WAAW,aAAa;AAE9B,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,UACE,SACA,QACuB;AACvB,UAAM,WAAc,YAAS;AAC7B,UAAMA,QAAU,QAAK,EAAE;AAGvB,QAAI,OAAsC;AAC1C,QAAI,QAAQ,WAAW,KAAK;AAC1B,aAAO;AAAA,IACT,WAAW,QAAQ,gBAAgB,KAAK,OAAO,MAAM;AAEnD,aAAO;AAAA,IACT;AAKA,UAAM,UAAU,WAAW;AAE3B,UAAM,iBAAiB,KAAK,IAAI,QAAQ,eAAe,OAAO,IAAI;AAClE,UAAM,oBAAoB,KAAK,MAAM,UAAU,cAAc;AAK7D,UAAM,sBAAsB,IAAI,KAAK,IAAI,QAAQ,UAAU,IAAK;AAChE,UAAM,oBAAoB,KAAK,MAAMA,QAAO,mBAAmB;AAG/D,UAAM,OAAO,KAAK,IAAI,mBAAmB,GAAG;AAC5C,QAAI,YAAY,KAAK,IAAI,mBAAmB,GAAG;AAG/C,QAAI,SAAS,aAAa;AACxB,kBAAYA;AAAA,IACd;AAEA,UAAM,cAAc,KAAK,IAAI,MAAM,SAAS;AAE5C,QAAI,SAAS;AACb,QAAI,SAAS,YAAY;AACvB,eAAS,yCAAyC,QAAQ,WAAW,KAAK,QAAQ,CAAC,CAAC,gDAAgD,WAAW;AAAA,IACjJ,WAAW,SAAS,aAAa;AAC/B,eAAS,uEAAuEA,KAAI;AAAA,IACtF,OAAO;AACL,eAAS,0CAA0C,QAAQ,gBAAgB,OAAO,MAAM,QAAQ,CAAC,CAAC;AAAA,IACpG;AAEA,QAAI,QAAQ,yBAAyB,OAAO,wBAAwB,aAAa;AAC/E,gBAAU;AAAA,8CAAwC,OAAO,qBAAqB,oCAAoC,WAAW;AAAA,IAC/H;AAEA,WAAO;AAAA,MACL;AAAA,MACA,iBAAiB;AAAA,MACjB,sBAAsB;AAAA,MACtB,sBAAsB,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,WAAW;AAAA,MACpF;AAAA,IACF;AAAA,EACF;AACF;;;AC9FO,IAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBlB,MAAM,CAAC,YAAsD;AAAA,IAC3D,QAAQ;AAAA,IACR;AAAA,EACF;AACF;","names":["cpus"]}

package/dist/index.node.cjs

@@ -10,12 +10,12 @@
 
 
 
-var _chunkX3NC7HS4cjs = require('./chunk-X3NC7HS4.cjs');
-require('./chunk-SJSPR4ZU.cjs');
 
 
 
 
+var _chunkWAPZDXSXcjs = require('./chunk-WAPZDXSX.cjs');
+require('./chunk-YXBEYVGY.cjs');
 
 
 
@@ -24,5 +24,13 @@ 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.BatchExecutor = _chunkWAPZDXSXcjs.BatchExecutor; exports.ContextManager = _chunkWAPZDXSXcjs.ContextManager; exports.FluxConsoleLogger = _chunkWAPZDXSXcjs.FluxConsoleLogger; exports.FluxEngine = _chunkWAPZDXSXcjs.FluxEngine; exports.FluxSilentLogger = _chunkWAPZDXSXcjs.FluxSilentLogger; exports.JsonFileTraceSink = _chunkWAPZDXSXcjs.JsonFileTraceSink; exports.MemoryLockProvider = _chunkWAPZDXSXcjs.MemoryLockProvider; exports.MemoryStorage = _chunkWAPZDXSXcjs.MemoryStorage; exports.OrbitFlux = _chunkWAPZDXSXcjs.OrbitFlux; exports.PostgreSQLStorage = _chunkWAPZDXSXcjs.PostgreSQLStorage; exports.RedisLockProvider = _chunkWAPZDXSXcjs.RedisLockProvider; exports.StateMachine = _chunkWAPZDXSXcjs.StateMachine; exports.StepExecutor = _chunkWAPZDXSXcjs.StepExecutor; exports.WorkflowBuilder = _chunkWAPZDXSXcjs.WorkflowBuilder; exports.createWorkflow = _chunkWAPZDXSXcjs.createWorkflow;
 //# sourceMappingURL=index.node.cjs.map

package/dist/index.node.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.node.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,8nBAAC","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.node.cjs"}
+{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core-ci-fix/packages/flux/dist/index.node.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,43BAAC","file":"/Users/carl/Dev/Carl/gravito-core-ci-fix/packages/flux/dist/index.node.cjs"}