@gravito/flux 1.0.0-beta.2 → 1.0.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.zh-TW.md +189 -0
  2. package/assets/flux-branching.svg +84 -0
  3. package/dist/bun.cjs +7 -0
  4. package/dist/bun.cjs.map +1 -0
  5. package/dist/{storage/BunSQLiteStorage.d.ts → bun.d.cts} +8 -5
  6. package/dist/bun.d.ts +72 -5
  7. package/dist/bun.js +2 -2
  8. package/dist/bun.js.map +1 -0
  9. package/dist/chunk-J37UUMLM.js +858 -0
  10. package/dist/chunk-J37UUMLM.js.map +1 -0
  11. package/dist/chunk-RPECIW7O.cjs +858 -0
  12. package/dist/chunk-RPECIW7O.cjs.map +1 -0
  13. package/dist/chunk-SJSPR4ZU.cjs +173 -0
  14. package/dist/chunk-SJSPR4ZU.cjs.map +1 -0
  15. package/dist/{chunk-qjdtqchy.js → chunk-ZAMVC732.js} +35 -7
  16. package/dist/chunk-ZAMVC732.js.map +1 -0
  17. package/dist/index.cjs +121 -0
  18. package/dist/index.cjs.map +1 -0
  19. package/dist/index.d.cts +43 -0
  20. package/dist/index.d.ts +40 -35
  21. package/dist/index.js +102 -460
  22. package/dist/index.js.map +1 -0
  23. package/dist/index.node.cjs +28 -0
  24. package/dist/index.node.cjs.map +1 -0
  25. package/dist/index.node.d.cts +499 -0
  26. package/dist/index.node.d.ts +494 -13
  27. package/dist/index.node.js +28 -0
  28. package/dist/index.node.js.map +1 -0
  29. package/dist/{types.d.ts → types-DvVHBmP6.d.cts} +59 -18
  30. package/dist/types-DvVHBmP6.d.ts +235 -0
  31. package/package.json +26 -22
  32. package/dist/builder/WorkflowBuilder.d.ts +0 -96
  33. package/dist/builder/WorkflowBuilder.d.ts.map +0 -1
  34. package/dist/builder/index.d.ts +0 -2
  35. package/dist/builder/index.d.ts.map +0 -1
  36. package/dist/bun.d.ts.map +0 -1
  37. package/dist/core/ContextManager.d.ts +0 -40
  38. package/dist/core/ContextManager.d.ts.map +0 -1
  39. package/dist/core/StateMachine.d.ts +0 -43
  40. package/dist/core/StateMachine.d.ts.map +0 -1
  41. package/dist/core/StepExecutor.d.ts +0 -34
  42. package/dist/core/StepExecutor.d.ts.map +0 -1
  43. package/dist/core/index.d.ts +0 -4
  44. package/dist/core/index.d.ts.map +0 -1
  45. package/dist/engine/FluxEngine.d.ts +0 -66
  46. package/dist/engine/FluxEngine.d.ts.map +0 -1
  47. package/dist/engine/index.d.ts +0 -2
  48. package/dist/engine/index.d.ts.map +0 -1
  49. package/dist/index.d.ts.map +0 -1
  50. package/dist/index.node.d.ts.map +0 -1
  51. package/dist/logger/FluxLogger.d.ts +0 -40
  52. package/dist/logger/FluxLogger.d.ts.map +0 -1
  53. package/dist/logger/index.d.ts +0 -2
  54. package/dist/logger/index.d.ts.map +0 -1
  55. package/dist/node/index.mjs +0 -619
  56. package/dist/orbit/OrbitFlux.d.ts +0 -107
  57. package/dist/orbit/OrbitFlux.d.ts.map +0 -1
  58. package/dist/orbit/index.d.ts +0 -2
  59. package/dist/orbit/index.d.ts.map +0 -1
  60. package/dist/storage/BunSQLiteStorage.d.ts.map +0 -1
  61. package/dist/storage/MemoryStorage.d.ts +0 -28
  62. package/dist/storage/MemoryStorage.d.ts.map +0 -1
  63. package/dist/storage/index.d.ts +0 -3
  64. package/dist/storage/index.d.ts.map +0 -1
  65. package/dist/types.d.ts.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-RPECIW7O.cjs","../src/builder/WorkflowBuilder.ts","../src/core/ContextManager.ts","../src/core/StateMachine.ts","../src/core/StepExecutor.ts","../src/storage/MemoryStorage.ts","../src/engine/FluxEngine.ts","../src/trace/JsonFileTraceSink.ts","../src/logger/FluxLogger.ts","../src/orbit/OrbitFlux.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-RPECIW7O.cjs","sourcesContent":[null,"/**\n * @fileoverview Workflow Builder - Fluent API for defining workflows\n *\n * Type-safe, chainable workflow definition.\n *\n * @module @gravito/flux/builder\n */\n\nimport type {\n StepDefinition,\n StepDescriptor,\n WorkflowContext,\n WorkflowDefinition,\n WorkflowDescriptor,\n} from '../types'\n\n/**\n * Step options\n */\ninterface StepOptions {\n retries?: number\n timeout?: number\n when?: (ctx: WorkflowContext) => boolean\n}\n\n/**\n * Workflow Builder\n *\n * Provides fluent API for defining workflows with type inference.\n *\n * @example\n * ```typescript\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 processOrder(ctx.data.order)\n * })\n * .commit('notify', async (ctx) => {\n * await sendEmail(ctx.data.order.email)\n * })\n * ```\n */\nexport class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>> {\n private _name: string\n private _steps: StepDefinition[] = []\n private _validateInput?: (input: unknown) => input is TInput\n\n constructor(name: string) {\n this._name = name\n }\n\n /**\n * Define input type\n *\n * This method is used for TypeScript type inference.\n */\n input<T>(): WorkflowBuilder<T, TData> {\n return this as unknown as WorkflowBuilder<T, TData>\n }\n\n /**\n * Define workflow data (state) type\n *\n * This method is used for TypeScript type inference.\n */\n data<T>(): WorkflowBuilder<TInput, T> {\n return this as unknown as WorkflowBuilder<TInput, T>\n }\n\n /**\n * Add input validator\n */\n validate(validator: (input: unknown) => input is TInput): this {\n this._validateInput = validator\n return this\n }\n\n /**\n * Add a step to the workflow\n */\n step(\n name: string,\n handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void,\n options?: StepOptions\n ): this {\n this._steps.push({\n name,\n handler: handler as (ctx: WorkflowContext) => Promise<void> | void,\n retries: options?.retries,\n timeout: options?.timeout,\n when: options?.when as ((ctx: WorkflowContext) => boolean) | undefined,\n commit: false,\n })\n return this\n }\n\n /**\n * Add a commit step (always executes, even on replay)\n *\n * Commit steps are for side effects that should not be skipped,\n * such as database writes or external API calls.\n */\n commit(\n name: string,\n handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void,\n options?: StepOptions\n ): this {\n this._steps.push({\n name,\n handler: handler as (ctx: WorkflowContext) => Promise<void> | void,\n retries: options?.retries,\n timeout: options?.timeout,\n when: options?.when as ((ctx: WorkflowContext) => boolean) | undefined,\n commit: true,\n })\n return this\n }\n\n /**\n * Build the workflow definition\n */\n build(): WorkflowDefinition<TInput, TData> {\n if (this._steps.length === 0) {\n throw new Error(`Workflow \"${this._name}\" has no steps`)\n }\n\n return {\n name: this._name,\n steps: [...this._steps],\n validateInput: this._validateInput,\n }\n }\n\n /**\n * Describe workflow (serializable metadata)\n */\n describe(): WorkflowDescriptor {\n const steps: StepDescriptor[] = this._steps.map((step) => ({\n name: step.name,\n commit: Boolean(step.commit),\n retries: step.retries,\n timeout: step.timeout,\n hasCondition: Boolean(step.when),\n }))\n\n return {\n name: this._name,\n steps,\n }\n }\n\n /**\n * Get workflow name\n */\n get name(): string {\n return this._name\n }\n\n /**\n * Get step count\n */\n get stepCount(): number {\n return this._steps.length\n }\n}\n\n/**\n * Create a new workflow builder\n *\n * @param name - Unique workflow name\n * @returns WorkflowBuilder instance\n *\n * @example\n * ```typescript\n * const uploadFlow = createWorkflow('image-upload')\n * .input<{ file: Buffer }>()\n * .step('resize', async (ctx) => {\n * ctx.data.resized = await sharp(ctx.input.file).resize(200).toBuffer()\n * })\n * .commit('save', async (ctx) => {\n * await storage.put(ctx.data.resized)\n * })\n * ```\n */\nexport function createWorkflow(name: string): WorkflowBuilder {\n return new WorkflowBuilder(name)\n}\n","/**\n * @fileoverview Context Manager for workflow execution\n *\n * Manages workflow context lifecycle and state snapshots.\n *\n * @module @gravito/flux/core\n */\n\nimport type { StepExecution, WorkflowContext, WorkflowState, WorkflowStatus } from '../types'\n\n/**\n * Generate unique ID using crypto.randomUUID (Web Standard)\n */\nfunction generateId(): string {\n return crypto.randomUUID()\n}\n\n/**\n * Context Manager\n *\n * Creates and manages workflow execution contexts.\n */\nexport class ContextManager {\n /**\n * Create a new workflow context\n */\n create<TInput, TData = any>(\n name: string,\n input: TInput,\n stepCount: number\n ): WorkflowContext<TInput, TData> {\n const history: StepExecution[] = Array.from({ length: stepCount }, (_, _i) => ({\n name: '',\n status: 'pending',\n retries: 0,\n }))\n\n return {\n id: generateId(),\n name,\n input,\n data: {} as TData,\n status: 'pending',\n currentStep: 0,\n history,\n }\n }\n\n /**\n * Restore context from saved state\n */\n restore<TInput, TData = any>(\n state: WorkflowState<TInput, TData>\n ): WorkflowContext<TInput, TData> {\n return {\n id: state.id,\n name: state.name,\n input: state.input as TInput,\n data: { ...state.data } as unknown as TData,\n status: state.status,\n currentStep: state.currentStep,\n history: state.history.map((h) => ({ ...h })),\n }\n }\n\n /**\n * Convert context to serializable state\n */\n toState<TInput, TData>(ctx: WorkflowContext<TInput, TData>): WorkflowState<TInput, TData> {\n return {\n id: ctx.id,\n name: ctx.name,\n status: ctx.status,\n input: ctx.input,\n data: { ...(ctx.data as any) },\n currentStep: ctx.currentStep,\n history: ctx.history.map((h) => ({ ...h })),\n createdAt: new Date(),\n updatedAt: new Date(),\n }\n }\n\n /**\n * Update context status (returns new context for immutability)\n */\n updateStatus<TInput, TData>(\n ctx: WorkflowContext<TInput, TData>,\n status: WorkflowStatus\n ): WorkflowContext<TInput, TData> {\n return {\n ...ctx,\n status,\n }\n }\n\n /**\n * Advance to next step\n */\n advanceStep<TInput, TData>(ctx: WorkflowContext<TInput, TData>): WorkflowContext<TInput, TData> {\n return {\n ...ctx,\n currentStep: ctx.currentStep + 1,\n }\n }\n\n /**\n * Update step name in history\n */\n setStepName<TInput, TData>(\n ctx: WorkflowContext<TInput, TData>,\n index: number,\n name: string\n ): void {\n if (ctx.history[index]) {\n ctx.history[index].name = name\n }\n }\n}\n","/**\n * @fileoverview State Machine for workflow status transitions\n *\n * Pure state machine with no runtime dependencies.\n *\n * @module @gravito/flux/core\n */\n\nimport type { WorkflowStatus } from '../types'\n\n/**\n * Valid state transitions\n */\nconst TRANSITIONS: Record<WorkflowStatus, WorkflowStatus[]> = {\n pending: ['running', 'failed'],\n running: ['paused', 'completed', 'failed'],\n paused: ['running', 'failed'],\n completed: [], // terminal state\n failed: ['pending'], // allow retry\n}\n\n/**\n * State Machine for workflow status management\n *\n * Provides validated state transitions using EventTarget for events.\n */\nexport class StateMachine extends EventTarget {\n private _status: WorkflowStatus = 'pending'\n\n /**\n * Current status\n */\n get status(): WorkflowStatus {\n return this._status\n }\n\n /**\n * Check if transition to target status is allowed\n */\n canTransition(to: WorkflowStatus): boolean {\n return TRANSITIONS[this._status].includes(to)\n }\n\n /**\n * Transition to a new status\n *\n * @throws {Error} If transition is not allowed\n */\n transition(to: WorkflowStatus): void {\n if (!this.canTransition(to)) {\n throw new Error(`Invalid state transition: ${this._status} → ${to}`)\n }\n\n const from = this._status\n this._status = to\n\n // Emit transition event\n this.dispatchEvent(\n new CustomEvent('transition', {\n detail: { from, to },\n })\n )\n }\n\n /**\n * Force set status (for replay/restore)\n */\n forceStatus(status: WorkflowStatus): void {\n this._status = status\n }\n\n /**\n * Check if workflow is in terminal state\n */\n isTerminal(): boolean {\n return this._status === 'completed' || this._status === 'failed'\n }\n\n /**\n * Check if workflow can be executed\n */\n canExecute(): boolean {\n return this._status === 'pending' || this._status === 'paused'\n }\n}\n","/**\n * @fileoverview Step Executor for workflow steps\n *\n * Handles step execution with retry and timeout support.\n *\n * @module @gravito/flux/core\n */\n\nimport type { StepDefinition, StepExecution, StepResult, WorkflowContext } from '../types'\n\n/**\n * Step Executor\n *\n * Executes individual workflow steps with retry and timeout support.\n */\nexport class StepExecutor {\n private defaultRetries: number\n private defaultTimeout: number\n private onRetry?: (\n step: StepDefinition<any, any>,\n ctx: WorkflowContext<any, any>,\n error: Error,\n attempt: number,\n maxRetries: number\n ) => void | Promise<void>\n\n constructor(\n options: {\n defaultRetries?: number\n defaultTimeout?: number\n onRetry?: (\n step: StepDefinition<any, any>,\n ctx: WorkflowContext<any, any>,\n error: Error,\n attempt: number,\n maxRetries: number\n ) => void | Promise<void>\n } = {}\n ) {\n this.defaultRetries = options.defaultRetries ?? 3\n this.defaultTimeout = options.defaultTimeout ?? 30000\n this.onRetry = options.onRetry\n }\n\n /**\n * Execute a step with retry and timeout\n */\n async execute<TInput, TData>(\n step: StepDefinition<TInput, TData>,\n ctx: WorkflowContext<TInput, TData>,\n execution: StepExecution\n ): Promise<StepResult> {\n const maxRetries = step.retries ?? this.defaultRetries\n const timeout = step.timeout ?? this.defaultTimeout\n const startTime = Date.now()\n\n // Check condition\n if (step.when && !step.when(ctx)) {\n execution.status = 'skipped'\n return {\n success: true,\n duration: 0,\n }\n }\n\n execution.status = 'running'\n execution.startedAt = new Date()\n\n let lastError: Error | undefined\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n execution.retries = attempt\n\n try {\n // Execute with timeout\n await this.executeWithTimeout(step.handler, ctx, timeout)\n\n execution.status = 'completed'\n execution.completedAt = new Date()\n execution.duration = Date.now() - startTime\n\n return {\n success: true,\n duration: execution.duration,\n }\n } catch (error) {\n lastError = error instanceof Error ? error : new Error(String(error))\n\n // If not last retry, continue\n if (attempt < maxRetries) {\n await this.onRetry?.(step, ctx, lastError, attempt + 1, maxRetries)\n // Exponential backoff\n await this.sleep(Math.min(1000 * 2 ** attempt, 10000))\n }\n }\n }\n\n // All retries failed\n execution.status = 'failed'\n execution.completedAt = new Date()\n execution.duration = Date.now() - startTime\n execution.error = lastError?.message\n\n return {\n success: false,\n error: lastError,\n duration: execution.duration,\n }\n }\n\n /**\n * Execute handler with timeout\n */\n private async executeWithTimeout<TInput, TData>(\n handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void,\n ctx: WorkflowContext<TInput, TData>,\n timeout: number\n ): Promise<void> {\n let timer: ReturnType<typeof setTimeout> | null = null\n try {\n const timeoutPromise = new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error('Step timeout')), timeout)\n })\n\n await Promise.race([Promise.resolve(handler(ctx)), timeoutPromise])\n } finally {\n if (timer) {\n clearTimeout(timer)\n }\n }\n }\n\n /**\n * Sleep helper\n */\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms))\n }\n}\n","/**\n * @fileoverview In-memory storage adapter\n *\n * Simple storage for development and testing.\n *\n * @module @gravito/flux/storage\n */\n\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * Memory Storage\n *\n * In-memory storage adapter for development and testing.\n * Data is not persisted across restarts.\n */\nexport class MemoryStorage implements WorkflowStorage {\n private store = new Map<string, WorkflowState>()\n\n async save(state: WorkflowState): Promise<void> {\n this.store.set(state.id, {\n ...state,\n updatedAt: new Date(),\n })\n }\n\n async load(id: string): Promise<WorkflowState | null> {\n return this.store.get(id) ?? null\n }\n\n async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n let results = Array.from(this.store.values())\n\n if (filter?.name) {\n results = results.filter((s) => s.name === filter.name)\n }\n\n if (filter?.status) {\n const statuses = Array.isArray(filter.status) ? filter.status : [filter.status]\n results = results.filter((s) => statuses.includes(s.status))\n }\n\n // Sort by createdAt desc\n results.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())\n\n // Apply pagination\n if (filter?.offset) {\n results = results.slice(filter.offset)\n }\n if (filter?.limit) {\n results = results.slice(0, filter.limit)\n }\n\n return results\n }\n\n async delete(id: string): Promise<void> {\n this.store.delete(id)\n }\n\n async init(): Promise<void> {\n // No-op for memory storage\n }\n\n async close(): Promise<void> {\n this.store.clear()\n }\n\n /**\n * Get store size (for testing)\n */\n size(): number {\n return this.store.size\n }\n}\n","/**\n * @fileoverview Flux Engine - Main workflow execution engine\n *\n * Orchestrates workflow execution with storage and event handling.\n *\n * @module @gravito/flux\n */\n\nimport { WorkflowBuilder } from '../builder/WorkflowBuilder'\nimport { ContextManager } from '../core/ContextManager'\nimport { StateMachine } from '../core/StateMachine'\nimport { StepExecutor } from '../core/StepExecutor'\nimport { MemoryStorage } from '../storage/MemoryStorage'\nimport type {\n FluxConfig,\n FluxResult,\n FluxTraceEvent,\n WorkflowContext,\n WorkflowDefinition,\n WorkflowState,\n WorkflowStorage,\n} from '../types'\n\n/**\n * Flux Engine\n *\n * Main workflow execution engine.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({ storage: new MemoryStorage() })\n *\n * const workflow = createWorkflow('process-order')\n * .input<{ orderId: string }>()\n * .step('fetch', async (ctx) => { ... })\n * .step('validate', async (ctx) => { ... })\n * .commit('save', async (ctx) => { ... })\n *\n * const result = await engine.execute(workflow, { orderId: '123' })\n * ```\n */\nexport class FluxEngine {\n private storage: WorkflowStorage\n private executor: StepExecutor\n private contextManager: ContextManager\n private config: FluxConfig\n\n constructor(config: FluxConfig = {}) {\n this.config = config\n this.storage = config.storage ?? new MemoryStorage()\n this.executor = new StepExecutor({\n defaultRetries: config.defaultRetries,\n defaultTimeout: config.defaultTimeout,\n onRetry: async (step, ctx, error, attempt, maxRetries) => {\n await this.emitTrace({\n type: 'step:retry',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: ctx.currentStep,\n commit: Boolean(step.commit),\n retries: attempt,\n maxRetries,\n error: error.message,\n status: 'running',\n })\n },\n })\n this.contextManager = new ContextManager()\n }\n\n /**\n * Execute a workflow with input data\n *\n * @param workflow - Workflow builder or definition\n * @param input - Input data for the workflow\n * @returns Execution result\n */\n async execute<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n input: TInput\n ): Promise<FluxResult<TData>> {\n const startTime = Date.now()\n const definition = this.resolveDefinition(workflow)\n\n // Validate input if validator provided\n if (definition.validateInput && !definition.validateInput(input)) {\n throw new Error(`Invalid input for workflow \"${definition.name}\"`)\n }\n\n // Create context\n const ctx = this.contextManager.create<TInput, TData>(\n definition.name,\n input,\n definition.steps.length\n ) as WorkflowContext<TInput, TData>\n\n // Create state machine\n const stateMachine = new StateMachine()\n\n // Save initial state\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return this.runFrom(definition, ctx, stateMachine, startTime, 0)\n }\n\n /**\n * Resume a paused or failed workflow\n *\n * @param workflowId - Workflow instance ID\n * @returns Execution result or null if not found\n */\n async resume<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n workflowId: string,\n options?: { fromStep?: number | string }\n ): Promise<FluxResult<TData> | null> {\n const definition = this.resolveDefinition(workflow)\n const state = await this.storage.load(workflowId)\n if (!state) {\n return null\n }\n if (state.name !== definition.name) {\n throw new Error(`Workflow name mismatch: ${state.name} !== ${definition.name}`)\n }\n if (state.history.length !== definition.steps.length) {\n throw new Error('Workflow definition changed; resume is not safe')\n }\n\n const ctx = this.contextManager.restore<TInput, TData>(state)\n const stateMachine = new StateMachine()\n stateMachine.forceStatus('pending')\n\n const startIndex = this.resolveStartIndex(definition, options?.fromStep, ctx.currentStep)\n this.resetHistoryFrom(ctx, startIndex)\n Object.assign(ctx, { status: 'pending', currentStep: startIndex })\n\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return this.runFrom(definition, ctx, stateMachine, Date.now(), startIndex, {\n resume: true,\n fromStep: startIndex,\n })\n }\n\n /**\n * Retry a specific step (replays from that step onward)\n */\n async retryStep<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n workflowId: string,\n stepName: string\n ): Promise<FluxResult<TData> | null> {\n const definition = this.resolveDefinition(workflow)\n const state = await this.storage.load(workflowId)\n if (!state) {\n return null\n }\n if (state.name !== definition.name) {\n throw new Error(`Workflow name mismatch: ${state.name} !== ${definition.name}`)\n }\n if (state.history.length !== definition.steps.length) {\n throw new Error('Workflow definition changed; retry is not safe')\n }\n\n const ctx = this.contextManager.restore<TInput, TData>(state)\n const stateMachine = new StateMachine()\n stateMachine.forceStatus('pending')\n\n const startIndex = this.resolveStartIndex(definition, stepName, ctx.currentStep)\n this.resetHistoryFrom(ctx, startIndex)\n Object.assign(ctx, { status: 'pending', currentStep: startIndex })\n\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return this.runFrom(definition, ctx, stateMachine, Date.now(), startIndex, {\n retry: true,\n fromStep: startIndex,\n })\n }\n\n /**\n * Get workflow state by ID\n */\n async get<TInput = any, TData = any>(\n workflowId: string\n ): Promise<WorkflowState<TInput, TData> | null> {\n return this.storage.load(workflowId) as Promise<WorkflowState<TInput, TData> | null>\n }\n\n /**\n * Save workflow state manually (e.g., for external updates)\n */\n async saveState<TInput, TData>(state: WorkflowState<TInput, TData>): Promise<void> {\n return this.storage.save(state)\n }\n\n /**\n * List workflows\n */\n async list(filter?: Parameters<WorkflowStorage['list']>[0]) {\n return this.storage.list(filter)\n }\n\n /**\n * Initialize engine (init storage)\n */\n async init(): Promise<void> {\n await this.storage.init?.()\n }\n\n /**\n * Shutdown engine (cleanup)\n */\n async close(): Promise<void> {\n await this.storage.close?.()\n }\n\n private resolveDefinition<TInput, TData>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>\n ): WorkflowDefinition<TInput, TData> {\n return workflow instanceof WorkflowBuilder ? workflow.build() : workflow\n }\n\n private resolveStartIndex<TInput, TData>(\n definition: WorkflowDefinition<TInput, TData>,\n fromStep: number | string | undefined,\n fallback: number\n ): number {\n if (typeof fromStep === 'number') {\n if (fromStep < 0 || fromStep >= definition.steps.length) {\n throw new Error(`Invalid step index: ${fromStep}`)\n }\n return fromStep\n }\n if (typeof fromStep === 'string') {\n const index = definition.steps.findIndex((step) => step.name === fromStep)\n if (index === -1) {\n throw new Error(`Step not found: ${fromStep}`)\n }\n return index\n }\n return Math.max(0, Math.min(fallback, definition.steps.length - 1))\n }\n\n private resetHistoryFrom<TInput, TData>(\n ctx: WorkflowContext<TInput, TData>,\n startIndex: number\n ): void {\n for (let i = startIndex; i < ctx.history.length; i++) {\n const entry = ctx.history[i]\n if (!entry) {\n continue\n }\n entry.status = 'pending'\n entry.startedAt = undefined\n entry.completedAt = undefined\n entry.duration = undefined\n entry.error = undefined\n entry.retries = 0\n }\n }\n\n private async runFrom<TInput, TData = any>(\n definition: WorkflowDefinition<TInput, TData>,\n ctx: WorkflowContext<TInput, TData>,\n stateMachine: StateMachine,\n startTime: number,\n startIndex: number,\n meta?: { resume?: boolean; retry?: boolean; fromStep?: number }\n ): Promise<FluxResult<TData>> {\n try {\n // Transition to running\n stateMachine.transition('running')\n Object.assign(ctx, { status: 'running' })\n await this.emitTrace({\n type: 'workflow:start',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: ctx.status,\n input: ctx.input,\n meta,\n })\n\n // Execute steps\n for (let i = startIndex; i < definition.steps.length; i++) {\n const step = definition.steps[i]!\n const execution = ctx.history[i]!\n\n // Update step name\n this.contextManager.setStepName(ctx, i, step.name)\n Object.assign(ctx, { currentStep: i })\n\n // Emit step start event\n this.config.on?.stepStart?.(step.name, ctx as any)\n await this.emitTrace({\n type: 'step:start',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n status: execution.status,\n meta,\n })\n\n // Execute step\n const result = await this.executor.execute(step, ctx, execution)\n\n if (result.success) {\n // Emit step complete event\n this.config.on?.stepComplete?.(step.name, ctx as any, result)\n if (execution.status === 'skipped') {\n await this.emitTrace({\n type: 'step:skipped',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n duration: result.duration,\n status: execution.status,\n meta,\n })\n } else {\n await this.emitTrace({\n type: 'step:complete',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n duration: result.duration,\n status: execution.status,\n meta,\n })\n }\n } else {\n // Emit step error event\n this.config.on?.stepError?.(step.name, ctx as any, result.error!)\n await this.emitTrace({\n type: 'step:error',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n duration: result.duration,\n error: result.error?.message,\n status: execution.status,\n meta,\n })\n\n // Fail workflow\n stateMachine.transition('failed')\n Object.assign(ctx, { status: 'failed' })\n\n await this.storage.save({\n ...this.contextManager.toState<TInput, TData>(ctx),\n error: result.error?.message,\n })\n\n return {\n id: ctx.id,\n status: 'failed',\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n error: result.error,\n }\n }\n\n // Save progress after each step\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n }\n\n // Complete workflow\n stateMachine.transition('completed')\n Object.assign(ctx, { status: 'completed' })\n\n await this.storage.save({\n ...this.contextManager.toState<TInput, TData>(ctx),\n completedAt: new Date(),\n })\n\n // Emit workflow complete event\n this.config.on?.workflowComplete?.(ctx as any)\n await this.emitTrace({\n type: 'workflow:complete',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: ctx.status,\n duration: Date.now() - startTime,\n data: ctx.data as Record<string, unknown>,\n meta,\n })\n\n return {\n id: ctx.id,\n status: 'completed',\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n }\n } catch (error) {\n const err = error instanceof Error ? error : new Error(String(error))\n\n // Emit workflow error event\n this.config.on?.workflowError?.(ctx as any, err)\n await this.emitTrace({\n type: 'workflow:error',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: 'failed',\n duration: Date.now() - startTime,\n error: err.message,\n meta,\n })\n\n stateMachine.forceStatus('failed')\n Object.assign(ctx, { status: 'failed' })\n\n await this.storage.save({\n ...this.contextManager.toState<TInput, TData>(ctx),\n error: err.message,\n })\n\n return {\n id: ctx.id,\n status: 'failed',\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n error: err,\n }\n }\n }\n\n private async emitTrace(event: FluxTraceEvent): Promise<void> {\n try {\n await this.config.trace?.emit(event)\n } catch {\n // Ignore trace failures to avoid breaking workflow execution\n }\n }\n}\n","/**\n * @fileoverview JSON file trace sink (NDJSON)\n *\n * Writes trace events to a newline-delimited JSON file.\n */\n\nimport { appendFile, mkdir, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\nimport type { FluxTraceEvent, FluxTraceSink } from '../types'\n\nexport interface JsonFileTraceSinkOptions {\n path: string\n reset?: boolean\n}\n\nexport class JsonFileTraceSink implements FluxTraceSink {\n private path: string\n private ready: Promise<void>\n\n constructor(options: JsonFileTraceSinkOptions) {\n this.path = options.path\n this.ready = this.init(options.reset ?? true)\n }\n\n private async init(reset: boolean): Promise<void> {\n await mkdir(dirname(this.path), { recursive: true })\n if (reset) {\n await writeFile(this.path, '', 'utf8')\n }\n }\n\n async emit(event: FluxTraceEvent): Promise<void> {\n await this.ready\n await appendFile(this.path, `${JSON.stringify(event)}\\n`, 'utf8')\n }\n}\n","/**\n * @fileoverview Console Logger for FluxEngine\n *\n * Default logger implementation using console.\n *\n * @module @gravito/flux\n */\n\nimport type { FluxLogger } from '../types'\n\n/**\n * Console Logger\n *\n * Default logger that outputs to console.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * logger: new FluxConsoleLogger()\n * })\n * ```\n */\nexport class FluxConsoleLogger implements FluxLogger {\n private prefix: string\n\n constructor(prefix = '[Flux]') {\n this.prefix = prefix\n }\n\n debug(message: string, ...args: unknown[]): void {\n console.debug(`${this.prefix} ${message}`, ...args)\n }\n\n info(message: string, ...args: unknown[]): void {\n console.info(`${this.prefix} ${message}`, ...args)\n }\n\n warn(message: string, ...args: unknown[]): void {\n console.warn(`${this.prefix} ${message}`, ...args)\n }\n\n error(message: string, ...args: unknown[]): void {\n console.error(`${this.prefix} ${message}`, ...args)\n }\n}\n\n/**\n * Silent Logger\n *\n * Logger that outputs nothing (for testing or production).\n */\nexport class FluxSilentLogger implements FluxLogger {\n debug(): void {}\n info(): void {}\n warn(): void {}\n error(): void {}\n}\n","/**\n * @fileoverview OrbitFlux - Gravito PlanetCore Integration\n *\n * Integrates FluxEngine with Gravito's PlanetCore for seamless workflow management.\n *\n * @module @gravito/flux\n */\n\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { BunSQLiteStorage } from '../storage/BunSQLiteStorage'\nimport { MemoryStorage } from '../storage/MemoryStorage'\nimport type { FluxConfig, FluxLogger, WorkflowStorage } from '../types'\n\n/**\n * Minimal PlanetCore interface for type compatibility\n * (Avoids importing @gravito/core sources which causes rootDir issues)\n */\ninterface PlanetCore {\n logger: {\n debug(message: string, ...args: unknown[]): void\n info(message: string, ...args: unknown[]): void\n warn(message: string, ...args: unknown[]): void\n error(message: string, ...args: unknown[]): void\n }\n services: {\n set(key: string, value: unknown): void\n get<T>(key: string): T | undefined\n }\n hooks: {\n doAction(name: string, payload?: unknown): void\n }\n}\n\n/**\n * GravitoOrbit interface\n */\nexport interface GravitoOrbit {\n install(core: PlanetCore): void | Promise<void>\n}\n\n/**\n * OrbitFlux configuration options\n */\nexport interface OrbitFluxOptions {\n /**\n * Storage driver: 'memory' | 'sqlite' | custom WorkflowStorage\n * @default 'memory'\n */\n storage?: 'memory' | 'sqlite' | WorkflowStorage\n\n /**\n * SQLite database path (only used if storage is 'sqlite')\n * @default ':memory:'\n */\n dbPath?: string\n\n /**\n * Service name in core.services\n * @default 'flux'\n */\n exposeAs?: string\n\n /**\n * Custom logger\n */\n logger?: FluxLogger\n\n /**\n * Default retry count for steps\n * @default 3\n */\n defaultRetries?: number\n\n /**\n * Default timeout for steps (ms)\n * @default 30000\n */\n defaultTimeout?: number\n}\n\n/**\n * OrbitFlux - Gravito Workflow Integration\n *\n * @example\n * ```typescript\n * import { OrbitFlux } from '@gravito/flux'\n *\n * const core = await PlanetCore.boot({\n * orbits: [\n * new OrbitFlux({ storage: 'sqlite', dbPath: './data/workflows.db' })\n * ]\n * })\n *\n * // Access via services\n * const flux = core.services.get<FluxEngine>('flux')\n * await flux.execute(myWorkflow, input)\n * ```\n */\nexport class OrbitFlux implements GravitoOrbit {\n private options: OrbitFluxOptions\n private engine?: FluxEngine\n\n constructor(options: OrbitFluxOptions = {}) {\n this.options = {\n storage: 'memory',\n exposeAs: 'flux',\n defaultRetries: 3,\n defaultTimeout: 30000,\n ...options,\n }\n }\n\n /**\n * Create OrbitFlux with configuration\n */\n static configure(options: OrbitFluxOptions = {}): OrbitFlux {\n return new OrbitFlux(options)\n }\n\n /**\n * Install into PlanetCore\n *\n * @param core - The PlanetCore instance\n */\n async install(core: PlanetCore): Promise<void> {\n const { storage, dbPath, exposeAs, defaultRetries, defaultTimeout, logger } = this.options\n\n // Resolve storage adapter\n let storageAdapter: WorkflowStorage\n\n if (typeof storage === 'string') {\n switch (storage) {\n case 'sqlite':\n storageAdapter = new BunSQLiteStorage({ path: dbPath })\n break\n default:\n storageAdapter = new MemoryStorage()\n }\n } else {\n storageAdapter = storage!\n }\n\n // Initialize storage\n await storageAdapter.init?.()\n\n // Create engine configuration\n const engineConfig: FluxConfig = {\n storage: storageAdapter,\n defaultRetries,\n defaultTimeout,\n logger: logger ?? {\n debug: (msg) => core.logger.debug(`[Flux] ${msg}`),\n info: (msg) => core.logger.info(`[Flux] ${msg}`),\n warn: (msg) => core.logger.warn(`[Flux] ${msg}`),\n error: (msg) => core.logger.error(`[Flux] ${msg}`),\n },\n on: {\n stepStart: (step) => {\n core.hooks.doAction('flux:step:start', { step })\n },\n stepComplete: (step, ctx, result) => {\n core.hooks.doAction('flux:step:complete', { step, ctx, result })\n },\n stepError: (step, ctx, error) => {\n core.hooks.doAction('flux:step:error', { step, ctx, error })\n },\n workflowComplete: (ctx) => {\n core.hooks.doAction('flux:workflow:complete', { ctx })\n },\n workflowError: (ctx, error) => {\n core.hooks.doAction('flux:workflow:error', { ctx, error })\n },\n },\n }\n\n // Create engine\n this.engine = new FluxEngine(engineConfig)\n\n // Register in core services\n core.services.set(exposeAs!, this.engine)\n\n core.logger.info(\n `[OrbitFlux] Initialized (Storage: ${typeof storage === 'string' ? storage : 'custom'})`\n )\n }\n\n /**\n * Get the FluxEngine instance\n */\n getEngine(): FluxEngine | undefined {\n return this.engine\n }\n}\n"]}
@@ -0,0 +1,173 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } 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; } var _class;// src/storage/BunSQLiteStorage.ts
2
+ var _bunsqlite = require('bun:sqlite');
3
+ var BunSQLiteStorage = (_class = class {
4
+
5
+
6
+ __init() {this.initialized = false}
7
+ constructor(options = {}) {;_class.prototype.__init.call(this);
8
+ this.db = new (0, _bunsqlite.Database)(_nullishCoalesce(options.path, () => ( ":memory:")));
9
+ this.tableName = _nullishCoalesce(options.tableName, () => ( "flux_workflows"));
10
+ }
11
+ /**
12
+ * Initialize storage (create tables)
13
+ */
14
+ async init() {
15
+ if (this.initialized) {
16
+ return;
17
+ }
18
+ this.db.run(`
19
+ CREATE TABLE IF NOT EXISTS ${this.tableName} (
20
+ id TEXT PRIMARY KEY,
21
+ name TEXT NOT NULL,
22
+ status TEXT NOT NULL,
23
+ input TEXT NOT NULL,
24
+ data TEXT NOT NULL,
25
+ current_step INTEGER NOT NULL,
26
+ history TEXT NOT NULL,
27
+ error TEXT,
28
+ created_at TEXT NOT NULL,
29
+ updated_at TEXT NOT NULL,
30
+ completed_at TEXT
31
+ )
32
+ `);
33
+ this.db.run(`
34
+ CREATE INDEX IF NOT EXISTS idx_${this.tableName}_name
35
+ ON ${this.tableName}(name)
36
+ `);
37
+ this.db.run(`
38
+ CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status
39
+ ON ${this.tableName}(status)
40
+ `);
41
+ this.db.run(`
42
+ CREATE INDEX IF NOT EXISTS idx_${this.tableName}_created
43
+ ON ${this.tableName}(created_at DESC)
44
+ `);
45
+ this.initialized = true;
46
+ }
47
+ /**
48
+ * Save workflow state
49
+ */
50
+ async save(state) {
51
+ await this.init();
52
+ const stmt = this.db.prepare(`
53
+ INSERT OR REPLACE INTO ${this.tableName}
54
+ (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at)
55
+ VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)
56
+ `);
57
+ stmt.run({
58
+ $id: state.id,
59
+ $name: state.name,
60
+ $status: state.status,
61
+ $input: JSON.stringify(state.input),
62
+ $data: JSON.stringify(state.data),
63
+ $currentStep: state.currentStep,
64
+ $history: JSON.stringify(state.history),
65
+ $error: _nullishCoalesce(state.error, () => ( null)),
66
+ $createdAt: state.createdAt.toISOString(),
67
+ $updatedAt: state.updatedAt.toISOString(),
68
+ $completedAt: _nullishCoalesce(_optionalChain([state, 'access', _2 => _2.completedAt, 'optionalAccess', _3 => _3.toISOString, 'call', _4 => _4()]), () => ( null))
69
+ });
70
+ }
71
+ /**
72
+ * Load workflow state by ID
73
+ */
74
+ async load(id) {
75
+ await this.init();
76
+ const stmt = this.db.prepare(`
77
+ SELECT * FROM ${this.tableName} WHERE id = $id
78
+ `);
79
+ const row = stmt.get({ $id: id });
80
+ if (!row) {
81
+ return null;
82
+ }
83
+ return this.rowToState(row);
84
+ }
85
+ /**
86
+ * List workflow states with optional filter
87
+ */
88
+ async list(filter) {
89
+ await this.init();
90
+ let query = `SELECT * FROM ${this.tableName} WHERE 1=1`;
91
+ const params = {};
92
+ if (_optionalChain([filter, 'optionalAccess', _5 => _5.name])) {
93
+ query += " AND name = $name";
94
+ params.$name = filter.name;
95
+ }
96
+ if (_optionalChain([filter, 'optionalAccess', _6 => _6.status])) {
97
+ if (Array.isArray(filter.status)) {
98
+ const placeholders = filter.status.map((_, i) => `$status${i}`).join(", ");
99
+ query += ` AND status IN (${placeholders})`;
100
+ filter.status.forEach((s, i) => {
101
+ params[`$status${i}`] = s;
102
+ });
103
+ } else {
104
+ query += " AND status = $status";
105
+ params.$status = filter.status;
106
+ }
107
+ }
108
+ query += " ORDER BY created_at DESC";
109
+ if (_optionalChain([filter, 'optionalAccess', _7 => _7.limit])) {
110
+ query += " LIMIT $limit";
111
+ params.$limit = filter.limit;
112
+ }
113
+ if (_optionalChain([filter, 'optionalAccess', _8 => _8.offset])) {
114
+ query += " OFFSET $offset";
115
+ params.$offset = filter.offset;
116
+ }
117
+ const stmt = this.db.prepare(query);
118
+ const rows = stmt.all(params);
119
+ return rows.map((row) => this.rowToState(row));
120
+ }
121
+ /**
122
+ * Delete workflow state
123
+ */
124
+ async delete(id) {
125
+ await this.init();
126
+ const stmt = this.db.prepare(`
127
+ DELETE FROM ${this.tableName} WHERE id = $id
128
+ `);
129
+ stmt.run({ $id: id });
130
+ }
131
+ /**
132
+ * Close database connection
133
+ */
134
+ async close() {
135
+ this.db.close();
136
+ this.initialized = false;
137
+ }
138
+ /**
139
+ * Convert SQLite row to WorkflowState
140
+ */
141
+ rowToState(row) {
142
+ return {
143
+ id: row.id,
144
+ name: row.name,
145
+ status: row.status,
146
+ input: JSON.parse(row.input),
147
+ data: JSON.parse(row.data),
148
+ currentStep: row.current_step,
149
+ history: JSON.parse(row.history),
150
+ error: _nullishCoalesce(row.error, () => ( void 0)),
151
+ createdAt: new Date(row.created_at),
152
+ updatedAt: new Date(row.updated_at),
153
+ completedAt: row.completed_at ? new Date(row.completed_at) : void 0
154
+ };
155
+ }
156
+ /**
157
+ * Get raw database (for advanced usage)
158
+ */
159
+ getDatabase() {
160
+ return this.db;
161
+ }
162
+ /**
163
+ * Run a vacuum to optimize database
164
+ */
165
+ vacuum() {
166
+ this.db.run("VACUUM");
167
+ }
168
+ }, _class);
169
+
170
+
171
+
172
+ exports.BunSQLiteStorage = BunSQLiteStorage;
173
+ //# sourceMappingURL=chunk-SJSPR4ZU.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-SJSPR4ZU.cjs","../src/storage/BunSQLiteStorage.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-SJSPR4ZU.cjs","sourcesContent":[null,"/**\n * @fileoverview Bun SQLite Storage Adapter\n *\n * High-performance storage using Bun's built-in SQLite.\n *\n * @module @gravito/flux/storage\n */\n\nimport { Database } from 'bun:sqlite'\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * SQLite Storage Options\n */\nexport interface BunSQLiteStorageOptions {\n /** Database file path (default: ':memory:') */\n path?: string\n /** Table name (default: 'flux_workflows') */\n tableName?: string\n}\n\n/**\n * Bun SQLite Storage\n *\n * High-performance storage adapter using Bun's built-in SQLite.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * storage: new BunSQLiteStorage({ path: './data/flux.db' })\n * })\n * ```\n */\nexport class BunSQLiteStorage implements WorkflowStorage {\n private db: Database\n private tableName: string\n private initialized = false\n\n constructor(options: BunSQLiteStorageOptions = {}) {\n this.db = new Database(options.path ?? ':memory:')\n this.tableName = options.tableName ?? 'flux_workflows'\n }\n\n /**\n * Initialize storage (create tables)\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 )\n `)\n\n // Create indexes for common queries\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 * Save workflow state\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)\n VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)\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 })\n }\n\n /**\n * Load workflow state by ID\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 * List workflow states with optional filter\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 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 // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rows = stmt.all(params as any) as SQLiteRow[]\n\n return rows.map((row) => this.rowToState(row))\n }\n\n /**\n * Delete workflow state\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 * Close database connection\n */\n async close(): Promise<void> {\n this.db.close()\n this.initialized = false\n }\n\n /**\n * Convert SQLite row to WorkflowState\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 }\n }\n\n /**\n * Get raw database (for advanced usage)\n */\n getDatabase(): Database {\n return this.db\n }\n\n /**\n * Run a vacuum to optimize database\n */\n vacuum(): void {\n this.db.run('VACUUM')\n }\n}\n\n/**\n * SQLite row type\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}\n"]}
@@ -1,8 +1,6 @@
1
- // @bun
2
1
  // src/storage/BunSQLiteStorage.ts
3
2
  import { Database } from "bun:sqlite";
4
-
5
- class BunSQLiteStorage {
3
+ var BunSQLiteStorage = class {
6
4
  db;
7
5
  tableName;
8
6
  initialized = false;
@@ -10,6 +8,9 @@ class BunSQLiteStorage {
10
8
  this.db = new Database(options.path ?? ":memory:");
11
9
  this.tableName = options.tableName ?? "flux_workflows";
12
10
  }
11
+ /**
12
+ * Initialize storage (create tables)
13
+ */
13
14
  async init() {
14
15
  if (this.initialized) {
15
16
  return;
@@ -43,6 +44,9 @@ class BunSQLiteStorage {
43
44
  `);
44
45
  this.initialized = true;
45
46
  }
47
+ /**
48
+ * Save workflow state
49
+ */
46
50
  async save(state) {
47
51
  await this.init();
48
52
  const stmt = this.db.prepare(`
@@ -64,6 +68,9 @@ class BunSQLiteStorage {
64
68
  $completedAt: state.completedAt?.toISOString() ?? null
65
69
  });
66
70
  }
71
+ /**
72
+ * Load workflow state by ID
73
+ */
67
74
  async load(id) {
68
75
  await this.init();
69
76
  const stmt = this.db.prepare(`
@@ -75,6 +82,9 @@ class BunSQLiteStorage {
75
82
  }
76
83
  return this.rowToState(row);
77
84
  }
85
+ /**
86
+ * List workflow states with optional filter
87
+ */
78
88
  async list(filter) {
79
89
  await this.init();
80
90
  let query = `SELECT * FROM ${this.tableName} WHERE 1=1`;
@@ -108,6 +118,9 @@ class BunSQLiteStorage {
108
118
  const rows = stmt.all(params);
109
119
  return rows.map((row) => this.rowToState(row));
110
120
  }
121
+ /**
122
+ * Delete workflow state
123
+ */
111
124
  async delete(id) {
112
125
  await this.init();
113
126
  const stmt = this.db.prepare(`
@@ -115,10 +128,16 @@ class BunSQLiteStorage {
115
128
  `);
116
129
  stmt.run({ $id: id });
117
130
  }
131
+ /**
132
+ * Close database connection
133
+ */
118
134
  async close() {
119
135
  this.db.close();
120
136
  this.initialized = false;
121
137
  }
138
+ /**
139
+ * Convert SQLite row to WorkflowState
140
+ */
122
141
  rowToState(row) {
123
142
  return {
124
143
  id: row.id,
@@ -128,18 +147,27 @@ class BunSQLiteStorage {
128
147
  data: JSON.parse(row.data),
129
148
  currentStep: row.current_step,
130
149
  history: JSON.parse(row.history),
131
- error: row.error ?? undefined,
150
+ error: row.error ?? void 0,
132
151
  createdAt: new Date(row.created_at),
133
152
  updatedAt: new Date(row.updated_at),
134
- completedAt: row.completed_at ? new Date(row.completed_at) : undefined
153
+ completedAt: row.completed_at ? new Date(row.completed_at) : void 0
135
154
  };
136
155
  }
156
+ /**
157
+ * Get raw database (for advanced usage)
158
+ */
137
159
  getDatabase() {
138
160
  return this.db;
139
161
  }
162
+ /**
163
+ * Run a vacuum to optimize database
164
+ */
140
165
  vacuum() {
141
166
  this.db.run("VACUUM");
142
167
  }
143
- }
168
+ };
144
169
 
145
- export { BunSQLiteStorage };
170
+ export {
171
+ BunSQLiteStorage
172
+ };
173
+ //# sourceMappingURL=chunk-ZAMVC732.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/storage/BunSQLiteStorage.ts"],"sourcesContent":["/**\n * @fileoverview Bun SQLite Storage Adapter\n *\n * High-performance storage using Bun's built-in SQLite.\n *\n * @module @gravito/flux/storage\n */\n\nimport { Database } from 'bun:sqlite'\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * SQLite Storage Options\n */\nexport interface BunSQLiteStorageOptions {\n /** Database file path (default: ':memory:') */\n path?: string\n /** Table name (default: 'flux_workflows') */\n tableName?: string\n}\n\n/**\n * Bun SQLite Storage\n *\n * High-performance storage adapter using Bun's built-in SQLite.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * storage: new BunSQLiteStorage({ path: './data/flux.db' })\n * })\n * ```\n */\nexport class BunSQLiteStorage implements WorkflowStorage {\n private db: Database\n private tableName: string\n private initialized = false\n\n constructor(options: BunSQLiteStorageOptions = {}) {\n this.db = new Database(options.path ?? ':memory:')\n this.tableName = options.tableName ?? 'flux_workflows'\n }\n\n /**\n * Initialize storage (create tables)\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 )\n `)\n\n // Create indexes for common queries\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 * Save workflow state\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)\n VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)\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 })\n }\n\n /**\n * Load workflow state by ID\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 * List workflow states with optional filter\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 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 // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rows = stmt.all(params as any) as SQLiteRow[]\n\n return rows.map((row) => this.rowToState(row))\n }\n\n /**\n * Delete workflow state\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 * Close database connection\n */\n async close(): Promise<void> {\n this.db.close()\n this.initialized = false\n }\n\n /**\n * Convert SQLite row to WorkflowState\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 }\n }\n\n /**\n * Get raw database (for advanced usage)\n */\n getDatabase(): Database {\n return this.db\n }\n\n /**\n * Run a vacuum to optimize database\n */\n vacuum(): void {\n this.db.run('VACUUM')\n }\n}\n\n/**\n * SQLite row type\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}\n"],"mappings":"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","names":[]}
package/dist/index.cjs ADDED
@@ -0,0 +1,121 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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; }
2
+
3
+
4
+
5
+
6
+
7
+
8
+
9
+
10
+
11
+
12
+
13
+ var _chunkRPECIW7Ocjs = require('./chunk-RPECIW7O.cjs');
14
+
15
+
16
+ var _chunkSJSPR4ZUcjs = require('./chunk-SJSPR4ZU.cjs');
17
+
18
+ // src/profiler/WorkflowProfiler.ts
19
+ var _os = require('os'); var os = _interopRequireWildcard(_os);
20
+ var WorkflowProfiler = class {
21
+ constructor(engine) {
22
+ this.engine = engine;
23
+ if (!this.engine) {
24
+ this.engine = new (0, _chunkRPECIW7Ocjs.FluxEngine)({
25
+ logger: new (0, _chunkRPECIW7Ocjs.FluxSilentLogger)()
26
+ });
27
+ }
28
+ }
29
+ /**
30
+ * Run a profile session for a specific workflow
31
+ */
32
+ async profile(workflow, input) {
33
+ try {
34
+ await this.engine.execute(workflow, input);
35
+ } catch (e) {
36
+ }
37
+ if (global.gc) {
38
+ global.gc();
39
+ }
40
+ const startCpu = process.cpuUsage();
41
+ const startMem = process.memoryUsage().heapUsed;
42
+ const startTime = process.hrtime.bigint();
43
+ await this.engine.execute(workflow, input);
44
+ const endTime = process.hrtime.bigint();
45
+ const endCpu = process.cpuUsage(startCpu);
46
+ const endMem = process.memoryUsage().heapUsed;
47
+ const durationNs = Number(endTime - startTime);
48
+ const durationMs = durationNs / 1e6;
49
+ const cpuUserMs = endCpu.user / 1e3;
50
+ const cpuSysMs = endCpu.system / 1e3;
51
+ const totalCpuMs = cpuUserMs + cpuSysMs;
52
+ const memDeltaBytes = Math.max(0, endMem - startMem);
53
+ const cpuRatio = totalCpuMs / durationMs;
54
+ return {
55
+ durationMs,
56
+ cpuUserMs,
57
+ cpuSysMs,
58
+ memDeltaBytes,
59
+ cpuRatio
60
+ };
61
+ }
62
+ /**
63
+ * Generate recommendations based on metrics and current environment
64
+ */
65
+ recommend(metrics, config) {
66
+ const totalMem = os.totalmem();
67
+ const cpus2 = os.cpus().length;
68
+ let type = "IO_BOUND";
69
+ if (metrics.cpuRatio > 0.5) {
70
+ type = "CPU_BOUND";
71
+ } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {
72
+ type = "MEMORY_BOUND";
73
+ }
74
+ const safeMem = totalMem * 0.7;
75
+ const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024);
76
+ const maxMemConcurrency = Math.floor(safeMem / perInstanceMem);
77
+ const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 1e-3);
78
+ const maxCpuConcurrency = Math.floor(cpus2 * cpuEfficiencyFactor);
79
+ const safe = Math.min(maxMemConcurrency, 200);
80
+ let efficient = Math.min(maxCpuConcurrency, 200);
81
+ if (type === "CPU_BOUND") {
82
+ efficient = cpus2;
83
+ }
84
+ const recommended = Math.min(safe, efficient);
85
+ let reason = "";
86
+ if (type === "IO_BOUND") {
87
+ reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`;
88
+ } else if (type === "CPU_BOUND") {
89
+ reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus2}) is recommended to prevent blocking.`;
90
+ } else {
91
+ reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`;
92
+ }
93
+ if (_optionalChain([config, 'optionalAccess', _ => _.configuredConcurrency]) && config.configuredConcurrency > recommended) {
94
+ reason += `
95
+ \u26A0\uFE0F Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`;
96
+ }
97
+ return {
98
+ type,
99
+ safeConcurrency: safe,
100
+ efficientConcurrency: efficient,
101
+ suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,
102
+ reason
103
+ };
104
+ }
105
+ };
106
+
107
+
108
+
109
+
110
+
111
+
112
+
113
+
114
+
115
+
116
+
117
+
118
+
119
+
120
+ exports.BunSQLiteStorage = _chunkSJSPR4ZUcjs.BunSQLiteStorage; exports.ContextManager = _chunkRPECIW7Ocjs.ContextManager; exports.FluxConsoleLogger = _chunkRPECIW7Ocjs.FluxConsoleLogger; exports.FluxEngine = _chunkRPECIW7Ocjs.FluxEngine; exports.FluxSilentLogger = _chunkRPECIW7Ocjs.FluxSilentLogger; exports.JsonFileTraceSink = _chunkRPECIW7Ocjs.JsonFileTraceSink; exports.MemoryStorage = _chunkRPECIW7Ocjs.MemoryStorage; exports.OrbitFlux = _chunkRPECIW7Ocjs.OrbitFlux; exports.StateMachine = _chunkRPECIW7Ocjs.StateMachine; exports.StepExecutor = _chunkRPECIW7Ocjs.StepExecutor; exports.WorkflowBuilder = _chunkRPECIW7Ocjs.WorkflowBuilder; exports.WorkflowProfiler = WorkflowProfiler; exports.createWorkflow = _chunkRPECIW7Ocjs.createWorkflow;
121
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.cjs","../src/profiler/WorkflowProfiler.ts"],"names":["cpus"],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.cjs","sourcesContent":[null,"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"]}
@@ -0,0 +1,43 @@
1
+ import { FluxEngine } from './index.node.cjs';
2
+ export { ContextManager, FluxConsoleLogger, FluxSilentLogger, JsonFileTraceSink, MemoryStorage, OrbitFlux, OrbitFluxOptions, StateMachine, StepExecutor, WorkflowBuilder, createWorkflow } from './index.node.cjs';
3
+ import { W as WorkflowDefinition } from './types-DvVHBmP6.cjs';
4
+ export { F as FluxConfig, a as FluxLogger, b as FluxResult, c as FluxTraceEvent, d as FluxTraceEventType, e as FluxTraceSink, S as StepDefinition, f as StepDescriptor, g as StepExecution, h as StepResult, i as WorkflowContext, j as WorkflowDescriptor, k as WorkflowFilter, l as WorkflowState, m as WorkflowStatus, n as WorkflowStorage } from './types-DvVHBmP6.cjs';
5
+ export { BunSQLiteStorage, BunSQLiteStorageOptions } from './bun.cjs';
6
+ import 'bun:sqlite';
7
+
8
+ interface ProfileMetrics {
9
+ durationMs: number;
10
+ cpuUserMs: number;
11
+ cpuSysMs: number;
12
+ memDeltaBytes: number;
13
+ cpuRatio: number;
14
+ }
15
+ interface ProfileRecommendation {
16
+ type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND';
17
+ safeConcurrency: number;
18
+ efficientConcurrency: number;
19
+ suggestedConcurrency: string;
20
+ reason: string;
21
+ }
22
+ /**
23
+ * Workflow Profiler
24
+ *
25
+ * Analyzes workflow performance characteristics to recommend
26
+ * optimal concurrency settings for Consumer workers.
27
+ */
28
+ declare class WorkflowProfiler {
29
+ private engine?;
30
+ constructor(engine?: FluxEngine | undefined);
31
+ /**
32
+ * Run a profile session for a specific workflow
33
+ */
34
+ profile<TInput>(workflow: WorkflowDefinition<TInput, any>, input: TInput): Promise<ProfileMetrics>;
35
+ /**
36
+ * Generate recommendations based on metrics and current environment
37
+ */
38
+ recommend(metrics: ProfileMetrics, config?: {
39
+ configuredConcurrency?: number;
40
+ }): ProfileRecommendation;
41
+ }
42
+
43
+ export { FluxEngine, type ProfileMetrics, type ProfileRecommendation, WorkflowDefinition, WorkflowProfiler };